PostQueuedCompletionStatus 関数
I/O 完了パケットを I/O 完了ポートにポストします。
構文
BOOL WINAPI PostQueuedCompletionStatus(
_In_ HANDLE CompletionPort,
_In_ DWORD dwNumberOfBytesTransferred,
_In_ ULONG_PTR dwCompletionKey,
_In_opt_ LPOVERLAPPED lpOverlapped
);
パラメーター
-
CompletionPort [in]
-
I/O 完了パケットがポストされる I/O 完了ポートへのハンドル。
-
dwNumberOfBytesTransferred [in]
-
GetQueuedCompletionStatus 関数の lpNumberOfBytesTransferred パラメーターを介して返される値。
-
dwCompletionKey [in]
-
GetQueuedCompletionStatus 関数の lpCompletionKey パラメーターを使用して返される値。
-
lpOverlapped [in, optional]
-
GetQueuedCompletionStatus 関数の lpOverlapped パラメーターを介して返される値。
戻り値
関数が成功すると、戻り値は 0 以外になります。
関数が失敗した場合は、0 を返します。 拡張エラー情報を取得するには、 GetLastError を呼び出します。
解説
I/O 完了パケットは 、GetQueuedCompletionStatus 関数の未処理の呼び出しを満たします。 この関数は、 PostQueuedCompletionStatus の呼び出しの 2 番目、3 番目、および 4 番目のパラメーターとして渡された 3 つの値を返します。 システムは、これらの値を使用または検証しません。 特に、 lpOverlapped パラメーターは OVERLAPPED 構造体を指す必要はありません。
Windows 8とWindows Server 2012では、この関数は次のテクノロジでサポートされています。
| テクノロジ | サポートされています |
|---|---|
| サーバー メッセージ ブロック (SMB) 3.0 プロトコル |
はい |
| SMB 3.0 Transparent Failover (TFO) |
はい |
| SMB 3.0 とスケールアウト ファイル共有 (SO) |
はい |
| クラスター共有ボリューム ファイル システム (CsvFS) |
はい |
| Resilient File System (ReFS) |
はい |
CsvFs は、圧縮ファイルに対してリダイレクトされた IO を実行します。
必要条件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows XP [デスクトップ アプリ |UWP アプリ] |
| サポートされている最小のサーバー |
Windows Server 2003 [デスクトップ アプリ |UWP アプリ] |
| Header |
|
| ライブラリ |
|
| [DLL] |
|