LPFN_RIODEREGISTERBUFFER回呼函式 (mswsock.h)

RIODeregisterBuffer 函式會取消註冊與 Winsock 已註冊 I/O 延伸模組搭配使用的已註冊緩衝區。

語法

LPFN_RIODEREGISTERBUFFER LpfnRioderegisterbuffer;

void LpfnRioderegisterbuffer(
  RIO_BUFFERID BufferId
)
{...}

參數

BufferId

識別已註冊緩衝區的描述項。

傳回值

無

備註

RIODeregisterBuffer 函式會取消註冊已註冊的緩衝區。 當緩衝區取消註冊時，應用程式會指出它是使用 在 BufferId 參數中傳遞的緩衝區標識碼來完成。 嘗試使用此緩衝區標識碼之其他函式的任何後續呼叫都會失敗。

如果仍在使用的緩衝區已取消註冊，則結果會未定義。 這被視為嚴重錯誤。 在RIODequeueCompletion 函式所傳回的RIORESULT 結構中，狀態會與正常狀態保持不變。 應用程式開發人員可以使用應用程式驗證器工具來偵測此錯誤狀況。

如果在 BufferId 參數中傳遞無效的緩衝區標識碼， 則RIODeregisterBuffer 函式會忽略此識別碼。

注意

在運行時間必須呼叫 WSAIoctl 函式，並指定 SIO_GET_MULTIPLE_EXTENSION_FUNCTION_POINTER opcode，以取得RIODeregisterBuffer 函式的函式指標。 傳遞至 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 市集應用程式支援此函式，Windows 8.1、Windows Server 2012 R2 和更新版本。

規格需求

需求	值
標頭	mswsock.h