PostQueuedCompletionStatus 関数 (ioapiset.h)
I/O 完了パケットを I/O 完了ポートに投稿します。
構文
BOOL PostQueuedCompletionStatus(
[in] HANDLE CompletionPort,
[in] DWORD dwNumberOfBytesTransferred,
[in] ULONG_PTR dwCompletionKey,
[in, optional] LPOVERLAPPED lpOverlapped
);
パラメーター
[in] CompletionPort
I/O 完了パケットの投稿先となる I/O 完了ポートへのハンドル。
[in] dwNumberOfBytesTransferred
GetQueuedCompletionStatus 関数の lpNumberOfBytesTransferred パラメーターを介して返される値。
[in] dwCompletionKey
GetQueuedCompletionStatus 関数の lpCompletionKey パラメーターを介して返される値。
[in, optional] lpOverlapped
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) | はい |
| スケールアウト ファイル共有 (SO) を使う SMB 3.0 | はい |
| クラスターの共有ボリューム ファイル システム (CsvFS) | はい |
| Resilient File System (ReFS) | はい |
CsvFs によって、圧縮されたファイルのリダイレクトされた IO が実行されます。
必要条件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP [デスクトップ アプリ | UWP アプリ] |
| サポートされている最小のサーバー | Windows Server 2003 [デスクトップ アプリのみ | UWP アプリ] |
| 対象プラットフォーム | Windows |
| ヘッダー | ioapiset.h (Windows.h を含む) |
| Library | Kernel32.lib |
| [DLL] | Kernel32.dll |