structure WSK_BUF (wsk.h)

Article
03/05/2024

La structure WSK_BUF définit une mémoire tampon de données utilisée pour envoyer et recevoir des données sur un socket.

Syntaxe

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

Membres

Mdl

Pointeur vers une liste de descripteurs mémoire (MDL). La MDL peut être une MDL unique ou la première MDL d’une chaîne MDL. Si le membre Length est égal à zéro, ce pointeur peut être NULL.

Offset

Décalage vers l’emplacement où les données commencent dans la MDL. Si le membre Mdl pointe vers la première MDL d’une chaîne MDL, ce décalage doit se trouver dans la mémoire tampon décrite par la première MDL de la chaîne. Si le membre Mdl a la valeur NULL, le membre Offset n’est pas utilisé.

Length

Lorsqu’une structure de WSK_BUF est utilisée pour décrire une mémoire tampon de données à envoyer sur un socket, ce membre spécifie le nombre d’octets de données dans la chaîne MDL (ou MDL) à envoyer.

Lorsqu’une structure de WSK_BUF est utilisée pour décrire une mémoire tampon pour recevoir des données à partir d’un socket, ce membre spécifie le nombre maximal d’octets à recevoir dans la chaîne MDL (ou MDL).

Lorsqu’une structure de WSK_BUF est contenue dans une structure WSK_DATA_INDICATION ou une structure WSK_DATAGRAM_INDICATION , ce membre spécifie le nombre d’octets de données reçues dans la chaîne MDL (ou MDL).

Remarques

Chaque MDL dans la chaîne MDL pointée par le membre Mdl décrit la mémoire verrouillée ou provenant d’un pool non paginé.

Lorsqu’une application WSK transmet un pointeur vers une structure WSK_BUF à la fonction WskReceive , l’application peut spécifier zéro pour le membre Length de la structure. Dans ce cas, le membre Mdl peut être NULL , car aucune donnée ne sera copiée dans la mémoire tampon.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans Windows Vista et versions ultérieures des systèmes d’exploitation Windows.
En-tête	wsk.h (inclure Wsk.h)