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) |