IHostIoCompletionManager::GetHostOverlappedSize メソッド
ホストにより I/O 要求に追加されようとしているカスタム データのサイズを取得します。
構文
HRESULT GetHostOverlappedSize (
[out] DWORD *pcbSize
);
パラメーター
pcbSize
[out] Win32 OVERLAPPED オブジェクトのサイズに加えて、共通言語ランタイム (CLR) によって割り当てられるバイト数へのポインター。
戻り値
| HRESULT | 説明 |
|---|---|
| S_OK | GetHostOverlappedSize が正常に返されました。 |
| HOST_E_CLRNOTAVAILABLE | CLR がプロセスに読み込まれていないか、CLR がマネージド コードを実行できないまたは呼び出しを正常に処理できない状態です。 |
| HOST_E_TIMEOUT | 呼び出しがタイムアウトになりました。 |
| HOST_E_NOT_OWNER | 呼び出し元がロックを所有していません。 |
| HOST_E_ABANDONED | ブロックされたスレッドまたはファイバーが待機しているときに、イベントが取り消されました。 |
| E_FAIL | 原因不明の致命的なエラーが発生しました。 メソッドにより E_FAIL が返されると、そのプロセス内で CLR が使用できなくなります。 後続のホスティング メソッドの呼び出しでは HOST_E_CLRNOTAVAILABLE が返されます。 |
解説
Windows プラットフォーム API に対するすべての非同期 I/O 呼び出しでは、ファイル ポインターの位置などの情報を提供する Win32 OVERLAPPED オブジェクトを受け取ります。 状態を維持するために、非同期 I/O 呼び出しを行うアプリケーションは、通常カスタム データを構造に追加します。 GetHostOverlappedSize と IHostIoCompletionManager::InitializeHostOverlapped により、このようなカスタム データをホストに含める機会が提供されます。
CLR により GetHostOverlappedSize メソッドが呼び出され、ホストにより OVERLAPPED オブジェクトに追加されるカスタム データのサイズを決定します。
Note
GetHostOverlappedSize は、1 回のみ呼び出されます。 ホストのカスタム データは、すべての I/O 要求に対して同じサイズである必要があります。
重要
OVERLAPPED オブジェクト自体のサイズは、pcbSize の値には含まれません。
OVERLAPPED 構造体については、Windows プラットフォームのドキュメントを参照してください。
必要条件
:「システム要件」を参照してください。
ヘッダー: MSCorEE.h
ライブラリ: MSCorEE.dll にリソースとして含まれます
.NET Framework のバージョン: 2.0 以降で使用可能
関連項目
.NET