WSK_BUF Struktur (wsk.h)

Artikel
02/07/2025

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;

Angehörige

Mdl

Ein Zeiger auf eine Speicherdeskriptorliste (MDL). Die MDL kann eine einzelne MDL oder die erste MDL in einer MDL-Kette sein. Wenn das element Length null ist, kann dieser Zeiger NULL-sein.

Offset

Ein Offset, an dem die Daten in der MDL beginnen. Wenn der Mdl Member auf die erste MDL in einer MDL-Kette verweist, muss dieser Offset innerhalb des Speicherpuffers sein, der von der ersten MDL in der Kette beschrieben wird. Wenn das Mdl Member NULL-ist, wird das Offset Member nicht verwendet.

Length

Wenn eine WSK_BUF Struktur verwendet wird, um einen Puffer von Daten zu beschreiben, die über einen Socket gesendet werden sollen, gibt dieses Element die Anzahl der Bytes in der MDL-Kette (oder MDL-Kette) an, die gesendet werden soll.

Wenn eine WSK_BUF-Struktur verwendet wird, um einen Puffer zum Empfangen von Daten aus einem Socket zu beschreiben, gibt dieses Element 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 dieses Element die Anzahl der Empfangenen Daten in der MDL -Kette (oder MDL-Kette) an.

Bemerkungen

Jede MDL in der MDL-Kette, auf die vom Mdl Member verwiesen wird, beschreibt den Speicher, der entweder gesperrt oder aus einem nicht ausgelagerten Pool stammt.

Wenn eine WSK-Anwendung einen Zeiger an eine WSK_BUF Struktur an die WskReceive--Funktion übergibt, kann die Anwendung null für das Length Member der Struktur angeben. In diesem Fall kann das Mdl--Element NULL- werden, da keine Daten in den Puffer kopiert werden.