struktur NDIS_SCATTER_GATHER_LIST_PARAMETERS (ndis.h)

Artikel
02/26/2024

Struktur NDIS_SCATTER_GATHER_LIST_PARAMETERS menentukan parameter yang digunakan NDIS untuk membangun daftar sebar/kumpulkan untuk buffer.

Sintaks

typedef struct _NDIS_SCATTER_GATHER_LIST_PARAMETERS {
  NDIS_OBJECT_HEADER           Header;
  ULONG                        Flags;
  NDIS_RECEIVE_QUEUE_ID        QueueId;
  NDIS_SHARED_MEMORY_USAGE     SharedMemoryUsage;
  PMDL                         Mdl;
  PVOID                        CurrentVa;
  ULONG                        Length;
  NDIS_PROCESS_SG_LIST_HANDLER ProcessSGListHandler;
  PVOID                        Context;
  PSCATTER_GATHER_LIST         ScatterGatherListBuffer;
  ULONG                        ScatterGatherListBufferSize;
  ULONG                        ScatterGatherListBufferSizeNeeded;
} NDIS_SCATTER_GATHER_LIST_PARAMETERS, *PNDIS_SCATTER_GATHER_LIST_PARAMETERS;

Anggota

Header

Struktur NDIS_OBJECT_HEADER untuk struktur (NDIS_SCATTER_GATHER_LIST_PARAMETERS). Driver mengatur anggota Jenis struktur yang ditentukan Header untuk NDIS_OBJECT_TYPE_DEFAULT, anggota Revisi ke NDIS_SCATTER_GATHER_LIST_PARAMETERS_REVISION_1 dan anggota Ukuran ke NDIS_SIZEOF_SCATTER_GATHER_LIST_PARAMETERS_REVISION_1.

Flags

Dicadangkan untuk NDIS.

QueueId

Nilai jenis NDIS_RECEIVE_QUEUE_ID yang berisi pengidentifikasi antrean. Pengidentifikasi antrean adalah bilangan bulat antara nol dan jumlah antrean yang didukung adaptor miniport. Nilai nol menunjukkan antrean default.

SharedMemoryUsage

Nilai enumerasi NDIS_SHARED_MEMORY_USAGE yang menentukan tujuan memori bersama.

Mdl

Penunjuk ke daftar deskriptor memori (MDL) yang menjelaskan buffer memori bersama.

CurrentVa

Nilai ULONG untuk alamat virtual saat ini.

Length

Nilai ULONG yang berisi panjang, dalam byte, dari buffer memori bersama.

ProcessSGListHandler

Penunjuk ke fungsi NetProcessSGList (NDIS_PROCESS_SG_LIST_HANDLER titik entri).

Context

Pointer ke blok informasi konteks yang dialokasikan driver yang menyimpan informasi tentang daftar sebar/kumpulkan. NDIS meneruskan informasi konteks dalam panggilan ke NetProcessSGList pada parameter Konteks .

ScatterGatherListBuffer

Penunjuk ke struktur SCATTER_GATHER_LIST .

ScatterGatherListBufferSize

Nilai ULONG yang berisi panjang, dalam byte, dari daftar sebar/kumpulkan.

ScatterGatherListBufferSizeNeeded

Nilai ULONG di mana NDIS menulis jumlah total byte yang diperlukan NDIS untuk berhasil membangun daftar sebar/kumpulkan.