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 函式忽略。

注意

呼叫 WSAIoctl 函式並指定了 SIO_GET_MULTIPLE_EXTENSION_FUNCTION_POINTER opcode，才能在運行時間取得RIOCloseCompletionQueue 函式的函式指標。 傳遞至 WSAIoctl 函式的輸入緩衝區必須包含 WSAID_MULTIPLE_RIO，這是全域唯一標識碼 (GUID) ，其值可識別 Winsock 已註冊的 I/O 延伸模組函式。 成功時， WSAIoctl 函式所傳回的輸出會包含 指向RIO_EXTENSION_FUNCTION_TABLE 結構的指標，其中包含 Winsock 已註冊 I/O 延伸模組函式的指標。 SIO_GET_MULTIPLE_EXTENSION_FUNCTION_POINTER IOCTL 定義於 Ws2def.h 頭檔中。 WSAID_MULTIPLE_RIO GUID 定義於 Mswsock.h 頭檔中。

 

Windows Phone 8：Windows Phone 8 和更新版本上的 Windows Phone Store 應用程式支援此函式。

Windows 8.1 和 Windows Server 2012 R2：Windows 8.1、Windows Server 2012 R2 及更新版本上的 Windows 市集應用程式支援此函式。

規格需求

需求 值
標頭 mswsock.h