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 | UWP apps] |
Minimum supported server |
Windows Server 2012 [desktop apps | UWP apps] |
Minimum supported phone |
Windows Phone 8 |
Header |
Mswsock.h |
Library |
Mswsock.lib |
DLL |
Mswsock.dll |