struktur NDIS_SHARED_MEMORY_PARAMETERS (ndis.h)

Artikel
08/07/2023

Struktur NDIS_SHARED_MEMORY_PARAMETERS menentukan parameter memori bersama untuk permintaan alokasi memori bersama.

Sintaks

typedef struct _NDIS_SHARED_MEMORY_PARAMETERS {
  NDIS_OBJECT_HEADER       Header;
  ULONG                    Flags;
  NDIS_RECEIVE_QUEUE_ID    QueueId;
  NDIS_HANDLE              SharedMemoryHandle;
  NODE_REQUIREMENT         PreferredNode;
  NDIS_SHARED_MEMORY_USAGE Usage;
  ULONG                    Length;
  PVOID                    VirtualAddress;
  ULONG                    SGListBufferLength;
  PSCATTER_GATHER_LIST     SGListBuffer;
  NDIS_NIC_SWITCH_VPORT_ID VPortId;
} NDIS_SHARED_MEMORY_PARAMETERS, *PNDIS_SHARED_MEMORY_PARAMETERS;

Anggota

Header

Jenis, revisi, dan ukuran struktur NDIS_SHARED_MEMORY_PARAMETERS. Anggota ini diformat sebagai struktur NDIS_OBJECT_HEADER .

Driver miniport harus mengatur anggota JenisHeader ke NDIS_OBJECT_TYPE_DEFAULT. Untuk menentukan versi struktur NDIS_SHARED_MEMORY_PARAMETERS, driver harus mengatur anggota RevisiHeader ke salah satu nilai berikut:

NDIS_SHARED_MEMORY_PARAMETERS_REVISION_2

Menambahkan VPortId untuk NDIS 6.30.

Atur anggota Ukuran ke NDIS_SIZEOF_SHARED_MEMORY_PARAMETERS_REVISION_2.

NDIS_SHARED_MEMORY_PARAMETERS_REVISION_1

Versi asli untuk NDIS 6.20.

Atur anggota Ukuran ke NDIS_SIZEOF_SHARED_MEMORY_PARAMETERS_REVISION_1.

Flags

Nilai UCHAR yang berisi bitwise ATAU dari nilai berikut:

NDIS_SHARED_MEM_PARAMETERS_CONTIGOUS

Memori bersama berada dalam blok memori yang bersebelahan.

QueueId

Nilai NDIS_RECEIVE_QUEUE_ID yang berisi antrean komputer virtual (VMQ) atau virtualisasi I/O akar tunggal (SR-IOV) menerima pengidentifikasi antrean. Pengidentifikasi ini adalah bilangan bulat antara nol dan jumlah antrean yang didukung adaptor miniport. Nilai NDIS_DEFAULT_RECEIVE_QUEUE_ID menentukan antrean terima default.

Catatan Dimulai dengan Windows Server 2012, antarmuka SR-IOV hanya mendukung antrean terima default pada port virtual default dan nondefault (VPorts). Driver Miniport yang mendukung antarmuka SR-IOV harus mengatur anggota QueueId ke NDIS_DEFAULT_RECEIVE_QUEUE_ID.

SharedMemoryHandle

Nilai NDIS_HANDLE yang mengidentifikasi blok memori bersama. NDIS menyediakan handel ini sebelum kembali dari Fungsi NdisAllocateSharedMemory .

PreferredNode

Nilai NODE_REQUIREMENT yang menunjukkan simpul pilihan untuk digunakan saat mengalokasikan memori. Jika driver tidak memiliki preferensi, maka nilai harus diatur ke MM_ANY_NODE_OK.

Usage

Nilai enumerasi NDIS_SHARED_MEMORY_USAGE yang menentukan tujuan memori bersama.

Length

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

VirtualAddress

Nilai PVOID yang berisi alamat virtual dasar memori bersama. NDIS menyediakan nilai ini sebelum kembali dari fungsi NdisAllocateSharedMemory .

SGListBufferLength

Nilai ULONG yang berisi panjang, dalam byte, dari buffer daftar pengumpul sebar.

SGListBuffer

Penunjuk ke struktur SCATTER_GATHER_LIST .

VPortId

Nilai NDIS_NIC_SWITCH_VPORT_ID yang menentukan pengidentifikasi port virtual (VPort) tempat memori bersama akan dialokasikan. Nilai ini harus menjadi pengidentifikasi VPort nondefault yang dilampirkan ke fungsi fisik (PF) adaptor miniport.

Catatan Driver miniport yang mendukung antarmuka VMQ harus mengatur anggota ini ke nol. Driver miniport yang mendukung antarmuka SR-IOV tidak boleh mengatur anggota ini ke nol (NDIS_DEFAULT_VPORT_ID).

Keterangan

Struktur NDIS_SHARED_MEMORY_PARAMETERS menentukan parameter memori bersama untuk permintaan alokasi memori bersama untuk antrean terima.

Driver NDIS meneruskan struktur ini ke fungsi NdisAllocateSharedMemory dan NDIS meneruskan struktur ini ke fungsi NetAllocateSharedMemory (ALLOCATE_SHARED_MEMORY_HANDLER titik masuk).