LPFN_RIOCLOSECOMPLETIONQUEUE コールバック関数 (mswsock.h)
RIOCloseCompletionQueue 関数は、Winsock 登録済み I/O 拡張機能との要求を送受信することで、I/O 完了通知に使用される既存の完了キューを閉じます。
構文
LPFN_RIOCLOSECOMPLETIONQUEUE LpfnRioclosecompletionqueue;
void LpfnRioclosecompletionqueue(
RIO_CQ CQ
)
{...}
パラメーター
CQ
既存の完了キューを識別する記述子。
戻り値
なし
解説
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 ストア アプリでサポートされています。
要件
要件 | 値 |
---|---|
Header | mswsock.h |