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
IoAPI.h (Windows.h を含む);
Windows Server 2008 R2、Windows 7、Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP の WinBase.h (Windows.h を含む)
ライブラリ
Kernel32.lib
[DLL]
Kernel32.dll

関連項目

CreateIoCompletionPort

ファイル管理の関数

GetQueuedCompletionStatus

オーバー ラップ