struktur NDIS_RECEIVE_QUEUE_PARAMETERS (ntddndis.h)

Artikel
08/07/2023

Struktur NDIS_RECEIVE_QUEUE_PARAMETERS berisi parameter konfigurasi antrean penerima.

Sintaks

typedef struct _NDIS_RECEIVE_QUEUE_PARAMETERS {
  NDIS_OBJECT_HEADER          Header;
  ULONG                       Flags;
  NDIS_RECEIVE_QUEUE_TYPE     QueueType;
  NDIS_RECEIVE_QUEUE_ID       QueueId;
  NDIS_RECEIVE_QUEUE_GROUP_ID QueueGroupId;
  GROUP_AFFINITY              ProcessorAffinity;
  ULONG                       NumSuggestedReceiveBuffers;
  ULONG                       MSIXTableEntry;
  ULONG                       LookaheadSize;
  NDIS_VM_NAME                VmName;
  NDIS_QUEUE_NAME             QueueName;
  ULONG                       PortId;
  ULONG                       InterruptCoalescingDomainId;
  NDIS_QOS_SQ_ID              QosSqId;
} NDIS_RECEIVE_QUEUE_PARAMETERS, *PNDIS_RECEIVE_QUEUE_PARAMETERS;

Anggota

Header

Jenis, revisi, dan ukuran struktur NDIS_RECEIVE_QUEUE_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_NIC_SWITCH_CAPABILITIES , driver harus mengatur anggota RevisiHeader ke salah satu nilai berikut:

NDIS_NIC_SWITCH_VPORT_PARAMETERS_REVISION_3

Menambahkan bidang QosSqId untuk NDIS 6.50.

Atur anggota Ukuran ke NDIS_SIZEOF_NIC_SWITCH_VPORT_PARAMETERS_REVISION_3.

NDIS_RECEIVE_QUEUE_PARAMETERS_REVISION_2

Menambahkan anggota tambahan untuk NDIS 6.30.

Atur anggota Ukuran ke NDIS_SIZEOF_RECEIVE_QUEUE_PARAMETERS_REVISION_2.

NDIS_RECEIVE_QUEUE_PARAMETERS_REVISION_1

Versi asli untuk NDIS 6.20.

Atur anggota Ukuran ke NDIS_SIZEOF_RECEIVE_QUEUE_PARAMETERS_REVISION_1.

Flags

Nilai ULONG yang berisi bitwise OR dari bendera berikut. Bendera berikut ini valid untuk OID_RECEIVE_FILTER_ALLOCATE_QUEUE OID dan kumpulan OID_RECEIVE_FILTER_QUEUE_PARAMETERS dan OID kueri:

NDIS_RECEIVE_QUEUE_PARAMETERS_PER_QUEUE_RECEIVE_INDICATION

Driver miniport tidak boleh mencampur paket jaringan untuk antrean penerima lainnya dengan paket untuk antrean ini dalam satu panggilan ke fungsi NdisMIndicateReceiveNetBufferLists .

NDIS_RECEIVE_QUEUE_PARAMETERS_LOOKAHEAD_SPLIT_REQUIRED

Adaptor jaringan harus membagi paket yang diterima pada offset yang sama dengan atau lebih besar dari ukuran lookahead yang diminta dan menggunakan DMA untuk mentransfer data lookahead dan data post-lookahead untuk memisahkan segmen memori bersama.

Catatan

Dimulai dengan NDIS 6.30, memisahkan data paket menjadi buffer lookahead terpisah tidak lagi didukung. Driver miniport yang mendukung NDIS 6.30 atau versi yang lebih baru harus mengabaikan bendera ini.

Bendera berikut ini valid untuk OID_RECEIVE_FILTER_QUEUE_PARAMETERS mengatur OID dan indikasi status NDIS_STATUS_RECEIVE_FILTER_QUEUE_PARAMETERS :

NDIS_RECEIVE_QUEUE_PARAMETERS_FLAGS_CHANGED

Pengaturan di anggota Bendera berubah.

NDIS_RECEIVE_QUEUE_PARAMETERS_PROCESSOR_AFFINITY_CHANGED

Pengaturan di anggota ProcessorAffinity berubah.

NDIS_RECEIVE_QUEUE_PARAMETERS_SUGGESTED_RECV_BUFFER_NUMBERS_CHANGED

Pengaturan di anggota NumSuggestedReceiveBuffers berubah.

NDIS_RECEIVE_QUEUE_PARAMETERS_NAME_CHANGED

Pengaturan di anggota QueueName berubah.

Catatan

Driver menentukan parameter antrean penerima mana yang telah diubah dengan menjalankan operasi AND bitwise antara definisi NDIS_RECEIVE_QUEUE_PARAMETERS_CHANGE_MASK dan nilai di anggota Bendera . Jika hasilnya nol, tidak ada parameter antrean yang diterima yang telah diubah.

QueueType

Nilai enumerasi NDIS_RECEIVE_QUEUE_TYPE yang menentukan jenis antrean terima.

QueueId

Nilai jenis NDIS_RECEIVE_QUEUE_ID yang berisi pengidentifikasi antrean terima. Pengidentifikasi ini adalah nilai bilangan bulat antara nol dan jumlah antrean yang didukung adaptor jaringan. Nilai NDIS_DEFAULT_RECEIVE_QUEUE_ID menentukan antrean terima default.

QueueGroupId

Anggota ini dicadangkan untuk NDIS.

ProcessorAffinity

Nilai GROUP_AFFINITY yang menentukan nomor grup dan bitmap CPU yang dapat dikaitkan dengan antrean ini. Setidaknya satu prosesor harus ditentukan. Oleh karena itu, nilainya tidak boleh nol.

NumSuggestedReceiveBuffers

Nilai ULONG yang berisi nilai yang disarankan untuk jumlah buffer penerima yang harus digunakan adaptor jaringan untuk mendukung antrean. Jumlah ini dapat disesuaikan relatif terhadap sumber daya yang tersedia atau sebanding dengan jumlah yang digunakan adaptor jaringan untuk antrean lain. Misalnya, jumlah aktual buffer penerima dapat dua kali lipat atau setengah dari nilai yang disarankan ini.

MSIXTableEntry

Anggota ini dicadangkan untuk NDIS.

LookaheadSize

Nilai ULONG untuk ukuran, dalam byte, dari persyaratan ukuran lookahead untuk antrean ini. Adaptor jaringan yang mendukung lookahead dalam antrean VM membagi paket yang diterima pada offset yang sama dengan atau lebih besar dari ukuran lookahead yang diminta dan menggunakan DMA untuk mentransfer data lookahead dan data post-lookahead untuk memisahkan segmen memori bersama. Jika LookaheadSize adalah nol, driver miniport tidak boleh membagi paket.

LookaheadSize valid saat NDIS mengatur bendera NDIS_RECEIVE_QUEUE_PARAMETERS_LOOKAHEAD_SPLIT_REQUIRED di anggota Bendera . Artinya, driver miniport harus membagi paket pada ukuran lookahead yang ditentukan jika bendera juga diatur. Jika bendera jelas, nilai bukan nol untuk LookaheadSize tidak valid.

Catatan

Dimulai dengan NDIS 6.30, memisahkan data paket menjadi buffer lookahead terpisah tidak lagi didukung. Nilai anggota ini harus nol.

VmName

Nilai NDIS_VM_NAME yang berisi deskripsi komputer virtual yang dibaca pengguna.

QueueName

Nilai NDIS_QUEUE_NAME yang berisi deskripsi antrean yang dibaca pengguna.

PortId

Nilai ULONG yang berisi pengidentifikasi unik port pada sakelar yang dapat diperluas Hyper-V tempat antrean VM terpasang.

InterruptCoalescingDomainId

Anggota ini dicadangkan untuk NDIS.

QosSqId

Mengaitkan Virtual Machine Queue (VMQ) dengan Scheduler Queue (SQ). Atur bidang ini ke nol tanpa asosiasi SQ. Untuk informasi selengkapnya tentang NDIS_QOS_SQ_ID, lihat OID_QOS_OFFLOAD_CREATE_SQ.

Dukungan Kualitas Layanan Perangkat Keras (QoS) untuk VMQ warisan tidak diperlukan. Driver miniport dapat mengembalikan NDIS_STATUS_NOT_SUPPORTED jika QosSqId bukan nol.

Keterangan

Struktur NDIS_RECEIVE_QUEUE_PARAMETERS digunakan dalam OID OID_RECEIVE_FILTER_ALLOCATE_QUEUE dan OID OID_RECEIVE_FILTER_QUEUE_PARAMETERS .

Dalam NDIS 6.30, struktur NDIS_RECEIVE_QUEUE_PARAMETERS juga digunakan dalam indikasi status NDIS_STATUS_RECEIVE_FILTER_QUEUE_PARAMETERS .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Didukung di NDIS 6.20 dan yang lebih baru.
Server minimum yang didukung	Windows Server 2022
Header	ntddndis.h (termasuk Ndis.h)