WSK_BUF struttura (wsk.h)

Articolo
02/27/2024

La struttura WSK_BUF definisce un buffer di dati usato per l'invio e la ricezione di dati su un socket.

Sintassi

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

Members

Mdl

Puntatore a un elenco di descrittori di memoria (MDL). MDL può essere un singolo MDL o il primo MDL in una catena MDL. Se il membro Length è zero, questo puntatore può essere NULL.

Offset

Offset a dove iniziano i dati in MDL. Se il membro Mdl punta al primo MDL in una catena MDL , questo offset deve trovarsi all'interno del buffer di memoria descritto dal primo MDL nella catena. Se il membro Mdl è NULL, il membro Offset non viene usato.

Length

Quando viene utilizzata una struttura WSK_BUF per descrivere un buffer di dati da inviare su un socket, questo membro specifica il numero di byte di dati nella catena MDL (o MDL) da inviare.

Quando viene usata una struttura WSK_BUF per descrivere un buffer per la ricezione di dati da un socket, questo membro specifica il numero massimo di byte da ricevere nella catena MDL (o MDL).

Quando una struttura WSK_BUF è contenuta all'interno di una struttura WSK_DATA_INDICATION o di una struttura WSK_DATAGRAM_INDICATION , questo membro specifica il numero di byte di dati ricevuti nella catena MDL (o MDL).

Commenti

Ogni MDL nella catena MDL a cui fa riferimento il membro Mdl descrive la memoria bloccata o dal pool non a pagina.

Quando un'applicazione WSK passa un puntatore a una struttura WSK_BUF alla funzione WskReceive , l'applicazione può specificare zero per il membro Length della struttura. In tale situazione, il membro Mdl può essere NULL perché non verranno copiati dati nel buffer.