estructura WSK_BUF (wsk.h)

Artículo
02/07/2025

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). La MDL puede ser una sola MDL o la primera MDL en 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 al primer MDL de una cadena MDL, este desplazamiento debe estar dentro del búfer de memoria descrito por el primer MDL de la cadena. Si el miembro de mdl es NULL, no se usa el miembro de offset de.

Length

Cuando se usa una estructura de WSK_BUF para describir un búfer de datos que se enviará 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).

Observaciones

Cada MDL de la cadena MDL a la que apunta el miembro mdl describe la memoria que está bloqueada o desde un 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 de longitud de la estructura. En esa situación, el miembro de Mdl puede ser NULL porque no se copiarán datos en el búfer.