WSK_BUF 構造体 (wsk.h)

[アーティクル]
08/08/2023

WSK_BUF構造体は、ソケット経由でデータを送受信するために使用されるデータバッファーを定義します。

構文

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

メンバー

Mdl

メモリ記述子リスト (MDL) へのポインター。 MDL には、1 つの MDL または MDL チェーン内の最初の MDL を指定できます。 Length メンバーが 0 の場合、このポインターは NULL にすることができます。

Offset

MDL でデータが開始される位置へのオフセット。 Mdl メンバーが MDL チェーン内の最初の MDL を指している場合、このオフセットは、チェーン内の最初の MDL によって記述されるメモリバッファー内にある必要があります。 Mdl メンバーが NULL の場合、Offset メンバーは使用されません。

Length

ソケット経由で送信されるデータのバッファーを記述するためにWSK_BUF構造体を使用する場合、このメンバーは、送信する MDL (または MDL チェーン) 内のデータのバイト数を指定します。

WSK_BUF構造体を使用してソケットからデータを受信するためのバッファーを記述する場合、このメンバーは MDL (または MDL チェーン) に受信する最大バイト数を指定します。

WSK_BUF構造体が WSK_DATA_INDICATION 構造体または WSK_DATAGRAM_INDICATION 構造体のいずれかに含まれている場合、このメンバーは MDL (または MDL チェーン) 内の受信データのバイト数を指定します。

注釈

Mdl メンバーが指す MDL チェーン内の各 MDL は、ロックされているメモリまたはページプール以外のメモリを記述します。

WSK アプリケーションが wskReceive 関数にWSK_BUF構造体へのポインターを渡すと、アプリケーションは構造体の Length メンバーに 0 を指定できます。その場合、データがバッファーにコピーされないため、 Mdl メンバーを NULL にすることができます。

要件

要件	値
サポートされている最小のクライアント	Windows Vista 以降のバージョンの Windows オペレーティングシステムで使用できます。
Header	wsk.h (Wsk.h を含む)