struktur WSK_BUF (wsk.h)

Artikel
02/07/2025

Struktur WSK_BUF menentukan buffer data yang digunakan untuk mengirim dan menerima data melalui soket.

Sintaksis

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

Anggota

Mdl

Penunjuk ke daftar deskriptor memori (MDL). MDL dapat menjadi MDL tunggal atau MDL pertama dalam rantai MDL. Jika anggota Panjang adalah nol, penunjuk ini dapat NULL.

Offset

Offset ke tempat data dimulai di MDL. Jika anggota Mdl menunjuk ke MDL pertama dalam rantai MDL, offset ini harus berada dalam buffer memori yang dijelaskan oleh MDL pertama dalam rantai. Jika anggota Mdl NULL , anggota Offset tidak digunakan.

Length

Ketika struktur WSK_BUF digunakan untuk menjelaskan buffer data yang akan dikirim melalui soket, anggota ini menentukan jumlah byte data dalam rantai MDL (atau MDL) yang akan dikirim.

Ketika struktur WSK_BUF digunakan untuk menjelaskan buffer untuk menerima data dari soket, anggota ini menentukan jumlah maksimum byte yang akan diterima ke dalam rantai MDL (atau MDL).

Ketika struktur WSK_BUF terkandung dalam struktur WSK_DATA_INDICATION atau struktur WSK_DATAGRAM_INDICATION, anggota ini menentukan jumlah byte data yang diterima dalam rantai MDL (atau MDL).

Komentar

Setiap MDL dalam rantai MDL yang ditunjukkan oleh anggota Mdl menjelaskan memori yang dikunci atau dari kumpulan non-halaman.

Ketika aplikasi WSK meneruskan penunjuk ke struktur WSK_BUF ke fungsi WskReceive, aplikasi dapat menentukan nol untuk Panjang anggota struktur. Dalam situasi itu, anggota Mdl dapat NULL karena tidak ada data yang akan disalin ke dalam buffer.