WSK_BUF-Struktur (wsk.h)

Artikel
02/27/2024

Die WSK_BUF-Struktur definiert einen Datenpuffer, der zum Senden und Empfangen von Daten über einen Socket verwendet wird.

Syntax

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

Member

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.

Hinweise

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.

Anforderungen

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)