функция обратного вызова LPFN_RIOCLOSECOMPLETIONQUEUE (mswsock.h)

Статья
02/29/2024

Функция RIOCloseCompletionQueue закрывает существующую очередь завершения, используемую для уведомления о завершении ввода-вывода, отправляя и получая запросы с помощью расширений ввода-вывода, зарегистрированных в Winsock.

Синтаксис

LPFN_RIOCLOSECOMPLETIONQUEUE LpfnRioclosecompletionqueue;

void LpfnRioclosecompletionqueue(
  RIO_CQ CQ
)
{...}

Параметры

CQ

Дескриптор, определяющий существующую очередь завершения.

Возвращаемое значение

None

Remarks

Функция RIOCloseCompletionQueue закрывает существующую очередь завершения, используемую для завершения ввода-вывода. RIO_CQ, переданный в параметре CQ, блокируется для записи ядром. Очередь завершения помечается как недопустимая, поэтому добавление новых завершений невозможно. Все новые дополнения, которые необходимо добавить, автоматически удаляются. Ожидается, что приложение будет отслеживать все ожидающие операции отправки или получения.

Если в параметре CQ передается недопустимая очередь завершения (например, RIO_INVALID_CQ), эта очередь игнорируется функцией RIOCloseCompletionQueue .

Примечание

Указатель на функцию RIOCloseCompletionQueue должен быть получен во время выполнения путем вызова функции WSAIoctl с указанным SIO_GET_MULTIPLE_EXTENSION_FUNCTION_POINTER кодом операции. Входной буфер, передаваемый в функцию WSAIoctl , должен содержать WSAID_MULTIPLE_RIO, глобальный уникальный идентификатор (GUID), значение которого определяет функции расширения операций ввода-вывода, зарегистрированные в Winsock. При успешном выполнении выходные данные, возвращаемые функцией WSAIoctl , содержат указатель на структуру RIO_EXTENSION_FUNCTION_TABLE , содержащую указатели на зарегистрированные функции расширения ввода-вывода Winsock. SIO_GET_MULTIPLE_EXTENSION_FUNCTION_POINTER IOCTL определяется в файле заголовка Ws2def.h. GUID WSAID_MULTIPLE_RIO определяется в файле заголовка Mswsock.h .

Windows Phone 8. Эта функция поддерживается для приложений Магазина Windows Phone на Windows Phone 8 и более поздних версиях.

Windows 8.1 и Windows Server 2012 R2. Эта функция поддерживается для приложений Магазина Windows на Windows 8.1, Windows Server 2012 R2 и более поздних версиях.

Требования

Требование	Значение
Заголовок	mswsock.h

Поделиться через