WSK_BUF-Struktur (wsk.h)
Die WSK_BUF-Struktur definiert einen Datenpuffer, der zum Senden und Empfangen von Daten über einen Socket verwendet wird.
typedef struct _WSK_BUF {
PMDL Mdl;
ULONG Offset;
SIZE_T Length;
} WSK_BUF, *PWSK_BUF;
Mdl
Ein Zeiger auf eine Speicherdeskriptorliste (Memory Descriptor List, MDL). Die MDL kann eine einzelne MDL oder die erste MDL in einer MDL-Kette sein. Wenn der Length-Member null ist, kann dieser Zeiger NULL sein.
Offset
Ein Offset zu dem Ort, an dem die Daten in der MDL beginnen. Wenn der Mdl-Member auf die erste MDL in einer MDL-Kette zeigt, muss sich dieser Offset innerhalb des Speicherpuffers befinden, der von der ersten MDL in der Kette beschrieben wird. Wenn der Mdl-MemberNULL ist, wird das Offset-Element nicht verwendet.
Length
Wenn eine WSK_BUF-Struktur verwendet wird, um einen Puffer von Daten zu beschreiben, der über einen Socket gesendet werden soll, gibt dieser Member die Anzahl der Bytes an, die in der MDL-Kette (oder MDL-Kette) gesendet werden sollen.
Wenn eine WSK_BUF-Struktur verwendet wird, um einen Puffer zum Empfangen von Daten von einem Socket zu beschreiben, gibt dieser Member die maximale Anzahl von Bytes an, die in die MDL-Kette (oder MDL-Kette) empfangen werden sollen.
Wenn eine WSK_BUF-Struktur entweder in einer WSK_DATA_INDICATION-Struktur oder einer WSK_DATAGRAM_INDICATION-Struktur enthalten ist, gibt dieser Member die Anzahl von Bytes der empfangenen Daten in der MDL-Kette (oder MDL-Kette) an.
Jede MDL in der MDL-Kette, auf die vom Mdl-Member verwiesen wird, beschreibt Speicher, der entweder gesperrt ist oder aus einem pool ohne Auslagerung stammt.
Wenn eine WSK-Anwendung einen Zeiger auf eine WSK_BUF-Struktur an die WskReceive-Funktion übergibt, kann die Anwendung null für den Length-Member der Struktur angeben. In diesem Fall kann der Mdl-MemberNULL sein, da keine Daten in den Puffer kopiert werden.
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme. |
Kopfzeile | wsk.h (einschließen von Wsk.h) |