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

Статья
02/07/2025

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

Синтаксис

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

Члены

Mdl

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

Offset

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

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 (include Wsk.h)