estructura WSK_BUF (wsk.h)

Artículo
03/05/2024

La estructura WSK_BUF define un búfer de datos que se usa para enviar y recibir datos a través de un socket.

Sintaxis

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

Miembros

Mdl

Puntero a una lista de descriptores de memoria (MDL). MdL puede ser una sola MDL o la primera MDL de una cadena MDL. Si el miembro Length es cero, este puntero puede ser NULL.

Offset

Desplazamiento a donde se inician los datos en MDL. Si el miembro Mdl apunta a la primera MDL de una cadena MDL, este desplazamiento debe estar dentro del búfer de memoria descrito por la primera MDL de la cadena. Si el miembro Mdl es NULL, no se usa el miembro Offset .

Length

Cuando se usa una estructura de WSK_BUF para describir un búfer de datos que se enviarán a través de un socket, este miembro especifica el número de bytes de datos en la cadena MDL (o MDL) que se va a enviar.

Cuando se usa una estructura de WSK_BUF para describir un búfer para recibir datos de un socket, este miembro especifica el número máximo de bytes que se van a recibir en la cadena MDL (o MDL).

Cuando una estructura de WSK_BUF se encuentra dentro de una estructura de WSK_DATA_INDICATION o una estructura de WSK_DATAGRAM_INDICATION , este miembro especifica el número de bytes de datos recibidos en la cadena MDL (o MDL).

Comentarios

Cada MDL de la cadena MDL a la que apunta el miembro Mdl describe la memoria bloqueada o del grupo no paginado.

Cuando una aplicación WSK pasa un puntero a una estructura de WSK_BUF a la función WskReceive , la aplicación puede especificar cero para el miembro Length de la estructura. En esa situación, el miembro Mdl puede ser NULL porque no se copiarán datos en el búfer.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows.
Encabezado	wsk.h (incluya Wsk.h)