EN
此内容没有您的语言版本,但有英语版本。

RIOCloseCompletionQueue function

The RIOCloseCompletionQueue function closes an existing completion queue used for I/O completion notification by send and receive requests with the Winsock registered I/O extensions.

Syntax


VOID  RIOCloseCompletionQueue(
  _In_  RIO_CQ CQ
);

Parameters

CQ [in]

A descriptor identifying an existing completion queue.

Return value

This function does not return a value.

Remarks

The RIOCloseCompletionQueue function closes an existing completion queue used for I/O completion. The RIO_CQ passed in the CQ parameter is locked for writing by the kernel. The completion queue is marked as invalid, so that new completions cannot be added. Any new completions to be added are silently dropped. The application is expected to tracking any pending send or receive operations.

If an invalid completion queue is passed in the CQ parameter (RIO_INVALID_CQ, for example), this is ignored by the RIOCloseCompletionQueue function.

Note  The function pointer to the RIOCloseCompletionQueue function must be obtained at run time by making a call to the WSAIoctl function with the SIO_GET_MULTIPLE_EXTENSION_FUNCTION_POINTER opcode specified. The input buffer passed to the WSAIoctl function must contain WSAID_MULTIPLE_RIO, a globally unique identifier (GUID) whose value identifies the Winsock registered I/O extension functions. On success, the output returned by the WSAIoctl function contains a pointer to the RIO_EXTENSION_FUNCTION_TABLE structure that contains pointers to the Winsock registered I/O extension functions. The SIO_GET_MULTIPLE_EXTENSION_FUNCTION_POINTER IOCTL is defined in the Ws2def.h header file. The WSAID_MULTIPLE_RIO GUID is defined in the Mswsock.h header file.

Windows Phone 8: This function is supported for Windows Phone Store apps on Windows Phone 8 and later.

Windows 8.1 and Windows Server 2012 R2: This function is supported for Windows Store apps on Windows 8.1, Windows Server 2012 R2, and later.

Requirements

Minimum supported client

Windows 8.1, Windows 8 [desktop apps only]

Minimum supported server

Windows Server 2012 [desktop apps only]

Minimum supported phone

Windows Phone 8

Header

Mswsock.h

Library

Mswsock.lib

DLL

Mswsock.dll

See also

RIO_CQ
RIO_EXTENSION_FUNCTION_TABLE
RIOCreateCompletionQueue
RIODequeueCompletion
RIONotify
WSAIoctl

 

 

社区附加资源

添加
显示:
© 2014 Microsoft