структура 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 никогда не следует использовать напрямую.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 8 [только классические приложения] |
| Минимальная версия сервера | Windows Server 2012 [только классические приложения] |
| Верхняя часть | mswsockdef.h (включая Mswsock.h) |