Partager via


structure WSK_BUF (wsk.h)

La structure WSK_BUF définit une mémoire tampon de données utilisée pour l’envoi et la réception de 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 de mémoire (MDL). Le MDL peut être un MDL unique ou le premier MDL dans 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 le MDL. Si le membre Mdl pointe vers le premier MDL d’une chaîne MDL, ce décalage doit se trouver dans la mémoire tampon décrite par le premier MDL de la chaîne. Si le membre Mdl est NULL, le membre Offset n’est pas utilisé.

Length

Lorsqu’une structure 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 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 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 de la chaîne MDL pointée par le membre Mdl décrit la mémoire verrouillée ou à partir d’un pool non paginé.

Lorsqu’une application WSK transmet un pointeur à 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.

Exigences

Exigence Valeur
client minimum pris en charge Disponible dans Windows Vista et versions ultérieures des systèmes d’exploitation Windows.
d’en-tête wsk.h (include Wsk.h)

Voir aussi

WSK_DATAGRAM_INDICATION

WSK_DATA_INDICATION

WskDisconnect

WskReceive

WskReceiveFrom

WskSend

WskSendTo