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

関連項目

CreateIoCompletionPort

File Management 関数

GetQueuedCompletionStatus

OVERLAPPED