estrutura WSK_BUF (wsk.h)

Artigo
02/27/2024

A estrutura WSK_BUF define um buffer de dados usado para enviar e receber dados por meio de um soquete.

Sintaxe

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

Membros

Mdl

Um ponteiro para uma MDL (lista de descritores de memória). O MDL pode ser um único MDL ou o primeiro MDL em uma cadeia de MDL. Se o membro Length for zero, esse ponteiro poderá ser NULL.

Offset

Um deslocamento para onde os dados começam no MDL. Se o membro Mdl apontar para o primeiro MDL em uma cadeia de MDL, esse deslocamento deverá estar dentro do buffer de memória descrito pelo primeiro MDL na cadeia. Se o membro Mdl for NULL, o membro Offset não será usado.

Length

Quando uma estrutura WSK_BUF é usada para descrever um buffer de dados a serem enviados por um soquete, esse membro especifica o número de bytes de dados na cadeia MDL (ou MDL) a ser enviada.

Quando uma estrutura WSK_BUF é usada para descrever um buffer para receber dados de um soquete, esse membro especifica o número máximo de bytes a serem recebidos na cadeia MDL (ou MDL).

Quando uma estrutura WSK_BUF está contida em uma estrutura WSK_DATA_INDICATION ou uma estrutura WSK_DATAGRAM_INDICATION , esse membro especifica o número de bytes de dados recebidos na cadeia MDL (ou MDL).

Comentários

Cada MDL na cadeia de MDL apontada pelo membro Mdl descreve a memória bloqueada ou do pool não paginado.

Quando um aplicativo WSK passa um ponteiro para uma estrutura WSK_BUF para a função WskReceive , o aplicativo pode especificar zero para o membro Length da estrutura. Nessa situação, o membro Mdl pode ser NULL porque nenhum dado será copiado para o buffer.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows.
Cabeçalho	wsk.h (inclua Wsk.h)