структура WSK_BUF (wsk.h)

Структура WSK_BUF определяет буфер данных, используемый для отправки и получения данных через сокет.

Синтаксис

typedef struct _WSK_BUF {
  PMDL   Mdl;
  ULONG  Offset;
  SIZE_T Length;
} WSK_BUF, *PWSK_BUF;

Члены

Mdl

Указатель на список дескрипторов памяти (MDL). MDL может быть одним MDL или первым MDL в цепочке MDL. Если элемент Length равен нулю, этот указатель может иметь значение NULL.

Offset

Смещение, с которого начинаются данные в MDL. Если элемент Mdl указывает на первый MDL в цепочке MDL, это смещение должно находиться в буфере памяти, описанном первым MDL в цепочке. Если элемент Mdl имеет значение NULL, элемент Offset не используется.

Length

Когда структура WSK_BUF используется для описания буфера данных, отправляемых через сокет, этот член указывает количество байтов данных в цепочке MDL (или MDL) для отправки.

Когда структура WSK_BUF используется для описания буфера для получения данных из сокета, этот элемент задает максимальное число байтов, полученных в цепочке MDL (или MDL).

Если структура WSK_BUF содержится в структуре WSK_DATA_INDICATION или WSK_DATAGRAM_INDICATION структуре, этот член указывает количество байтов полученных данных в цепочке MDL (или MDL).

Комментарии

Каждый MDL в цепочке MDL, на которую указывает элемент Mdl , описывает память, которая либо заблокирована, либо из нестраничного пула.

Когда приложение WSK передает указатель на WSK_BUF структуру функции WskReceive , приложение может указать нуль для элемента Length структуры. В этом случае элемент Mdl может иметь значение NULL , так как данные не будут скопированы в буфер.

Требования

Требование Значение
Минимальная версия клиента Доступно в Windows Vista и более поздних версиях операционных систем Windows.
Верхняя часть wsk.h (включая Wsk.h)

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

WSK_DATAGRAM_INDICATION

WSK_DATA_INDICATION

WskDisconnect

WskReceive

WskReceiveFrom

WskSend

WskSendTo