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

Статья
08/25/2023

Функция RIODeregisterBuffer отменяет регистрацию зарегистрированного буфера, используемого с зарегистрированными расширениями ввода-вывода Winsock.

Синтаксис

LPFN_RIODEREGISTERBUFFER LpfnRioderegisterbuffer;

void LpfnRioderegisterbuffer(
  RIO_BUFFERID BufferId
)
{...}

Параметры

BufferId

Дескриптор, определяющий зарегистрированный буфер.

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

None

Remarks

Функция RIODeregisterBuffer отменяет регистрацию зарегистрированного буфера. При отмене регистрации буфера приложение указывает, что это сделано с помощью идентификатора буфера, переданного в параметре BufferId . Все последующие вызовы других функций, которые пытаются использовать этот идентификатор буфера, завершатся ошибкой.

Если буфер, который по-прежнему используется, отменяется регистрация, результаты не определены. Это считается серьезной ошибкой. В структуре RIORESULT , возвращаемой функцией RIODequeueCompletion , состояние не изменится от обычного. Разработчик приложения может обнаружить эту ошибку с помощью средства проверки приложений.

Если в параметре BufferId передается недопустимый идентификатор буфера, это игнорируется функцией RIODeregisterBuffer .

Примечание

Указатель на функцию RIODeregisterBuffer должен быть получен во время выполнения путем вызова функции 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

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