struktur NDIS_RECEIVE_QUEUE_INFO (ntddndis.h)

Artikel
03/01/2024

Struktur NDIS_RECEIVE_QUEUE_INFO berisi informasi tentang antrean terima pada adaptor jaringan.

Sintaks

typedef struct _NDIS_RECEIVE_QUEUE_INFO {
  NDIS_OBJECT_HEADER                   Header;
  ULONG                                Flags;
  NDIS_RECEIVE_QUEUE_TYPE              QueueType;
  NDIS_RECEIVE_QUEUE_ID                QueueId;
  NDIS_RECEIVE_QUEUE_GROUP_ID          QueueGroupId;
  NDIS_RECEIVE_QUEUE_OPERATIONAL_STATE QueueState;
  GROUP_AFFINITY                       ProcessorAffinity;
  ULONG                                NumSuggestedReceiveBuffers;
  ULONG                                MSIXTableEntry;
  ULONG                                LookaheadSize;
  NDIS_VM_NAME                         VmName;
  NDIS_QUEUE_NAME                      QueueName;
  ULONG                                NumFilters;
  ULONG                                InterruptCoalescingDomainId;
} NDIS_RECEIVE_QUEUE_INFO, *PNDIS_RECEIVE_QUEUE_INFO;

Anggota

Header

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

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

NDIS_RECEIVE_QUEUE_INFO_REVISION_2

Menambahkan anggota tambahan untuk NDIS 6.30.

Catatan Revisi 2 struktur ini hanya didukung pada Windows Server 2012 dan versi Windows Server yang lebih baru.

Atur anggota Ukuran ke NDIS_SIZEOF_RECEIVE_QUEUE_INFO_REVISION_2.

NDIS_RECEIVE_QUEUE_INFO_REVISION_1

Versi asli untuk NDIS 6.20.

Atur anggota Ukuran ke NDIS_SIZEOF_RECEIVE_QUEUE_INFO_REVISION_1.

Flags

Nilai ULONG yang berisi bitwise OR dari bendera. Anggota ini dicadangkan untuk NDIS.

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.

QueueState

Nilai enumerasi NDIS_RECEIVE_QUEUE_OPERATIONAL_STATE yang menentukan status operasional antrean terima.

ProcessorAffinity

Bitmap GROUP_AFFINITY yang menentukan CPU yang memiliki afinitas antrean. Misalnya, pengaturan bit 0 menunjukkan bahwa CPU 0 digunakan, pengaturan bit 1 menunjukkan bahwa CPU 1 digunakan, dan sebagainya. Karena antrean VM dikaitkan dengan satu CPU, semua indikasi penerima untuk antrean ditangani pada prosesor tersebut.

NumSuggestedReceiveBuffers

Nilai ULONG yang berisi nilai yang disarankan untuk jumlah buffer penerima yang harus digunakan adaptor jaringan untuk mendukung antrean. Angka ini dapat disesuaikan relatif terhadap sumber daya yang telah tersedia driver miniport atau sebanding dengan angka yang digunakan adaptor jaringan untuk antrean lain. Misalnya, jumlah buffer penerima yang sebenarnya bisa dua atau setengah dari nilai yang disarankan ini.

MSIXTableEntry

Nilai ULONG yang berisi indeks entri tabel MSI-X untuk antrean.

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.

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

VmName

Nilai NDIS_VM_NAME yang berisi deskripsi komputer virtual yang mudah digunakan.

QueueName

Nilai NDIS_QUEUE_NAME yang berisi deskripsi antrean yang mudah digunakan.

NumFilters

Nilai ULONG yang menentukan jumlah filter terima yang telah dikonfigurasi pada adaptor jaringan.

Catatan Dimulai dengan NDIS 6.30, driver miniport harus mempertahankan penghitung untuk jumlah filter penerima saat ini yang diatur pada adaptor jaringan. Driver harus menaikkan penghitung setiap kali filter penerima diatur melalui permintaan set OID OID_RECEIVE_FILTER_SET_FILTER. Driver juga harus menurunkan penghitung setiap kali filter penerima dibersihkan melalui permintaan set OID OID_RECEIVE_FILTER_CLEAR_FILTER.

InterruptCoalescingDomainId

Nilai ULONG yang dicadangkan untuk digunakan oleh NDIS. Nilai ini digunakan untuk tujuan informasi oleh driver miniport.

Keterangan

Struktur NDIS_RECEIVE_QUEUE_INFO digunakan dengan NDIS_RECEIVE_QUEUE_INFO_ARRAY struktur untuk OID_RECEIVE_FILTER_ENUM_QUEUES OID yang menghitung menerima antrean pada adaptor jaringan.

Dengan pengembalian yang berhasil dari OID_RECEIVE_FILTER_ENUM_QUEUES, NDIS menyediakan struktur NDIS_RECEIVE_QUEUE_INFO_ARRAY yang menentukan properti array antrean penerima. Setiap elemen dalam array adalah struktur NDIS_RECEIVE_QUEUE_INFO .