структура RIO_BUF (mswsockdef.h)

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

Синтаксис

typedef struct _RIO_BUF {
  RIO_BUFFERID BufferId;
  ULONG        Offset;
  ULONG        Length;
} RIO_BUF, *PRIO_BUF;

Члены

BufferId

Дескриптор зарегистрированного буфера для зарегистрированного буфера ввода-вывода Winsock, используемого с запросами на отправку и получение.

Offset

Смещение (в байтах) в буфер, заданный элементом BufferId . Значение Offset , равное нулю, указывает на начало буфера.

Length

Длина (в байтах) буфера, используемого из элемента Offset .

Комментарии

Зарегистрированные расширения ввода-вывода Winsock часто работают с частями зарегистрированных буферов, которые иногда называют буферными срезами. Структура RIO_BUF используется приложением, которое должно использовать небольшой объем зарегистрированной памяти для отправки или получения сетевых данных. Приложение часто может повысить производительность путем регистрации одного большого буфера и последующего использования небольших блоков буфера по мере необходимости. Структура RIO_BUF может описывать любой непрерывный сегмент памяти, содержащийся в одной регистрации буфера.

Указатель на структуру RIO_BUF передается в качестве параметра pData в функции RIOSend, RIOSendEx, RIOReceive и RIOReceiveEx для отправки или получения сетевых данных.

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

Структура RIO_BUF определяется в файле заголовка Mswsockdef.h , который автоматически включается в файл заголовка Mswsock.h . Файл заголовка Mswsockdef.h никогда не следует использовать напрямую.

Требования

См. также раздел

RIODeregisterBuffer

RIOReceive

RIOReceiveEx

RIORegisterBuffer

RIOSend

RIOSendEx

RIO_BUFFERID