ホーム › Networking.WinSock › LPFN_RIOCLOSECOMPLETIONQUEUE

LPFN_RIOCLOSECOMPLETIONQUEUE

コールバック

シグネチャ

void LPFN_RIOCLOSECOMPLETIONQUEUE(
    RIO_CQ CQ
);

パラメーター

フィールド	型	説明
CQ	RIO_CQ	既存の完了キューを識別する記述子です。

公式ドキュメント

RIOCloseCompletionQueue 関数は、Winsock 登録 I/O 拡張による送信要求および受信要求の I/O 完了通知に使用される、既存の完了キューを閉じます。

解説(Remarks)

RIOCloseCompletionQueue 関数は、I/O 完了に使用される既存の完了キューを閉じます。CQ パラメーターに渡された RIO_CQ は、カーネルによって書き込み用にロックされます。完了キューは無効としてマークされ、新しい完了を追加できなくなります。追加されようとした新しい完了は、通知なく破棄されます。保留中の送信操作および受信操作の追跡は、アプリケーション側で行う必要があります。

CQ パラメーターに無効な完了キュー (たとえば RIO_INVALID_CQ) が渡された場合、RIOCloseCompletionQueue 関数はこれを無視します。

メモ

RIOCloseCompletionQueue 関数の関数ポインターは、実行時に SIO_GET_MULTIPLE_EXTENSION_FUNCTION_POINTER オペコードを指定して WSAIoctl 関数を呼び出して取得する必要があります。WSAIoctl 関数に渡す入力バッファーには、Winsock 登録 I/O 拡張関数を識別する値を持つグローバル一意識別子 (GUID) である WSAID_MULTIPLE_RIO を格納する必要があります。成功した場合、WSAIoctl 関数が返す出力には、Winsock 登録 I/O 拡張関数へのポインターを含む RIO_EXTENSION_FUNCTION_TABLE 構造体へのポインターが格納されます。SIO_GET_MULTIPLE_EXTENSION_FUNCTION_POINTER IOCTL は Ws2def.h ヘッダーファイルで定義されています。WSAID_MULTIPLE_RIO GUID は Mswsock.h ヘッダーファイルで定義されています。

Windows Phone 8: この関数は、Windows Phone 8 以降の Windows Phone ストアアプリでサポートされます。

Windows 8.1 および Windows Server 2012 R2: この関数は、Windows 8.1、Windows Server 2012 R2 以降の Windows ストアアプリでサポートされます。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)