struktur NDIS_RECEIVE_FILTER_INFO_ARRAY (ntddndis.h)

Artikel
08/07/2023

Struktur NDIS_RECEIVE_FILTER_INFO_ARRAY menentukan daftar filter terima yang saat ini dikonfigurasi pada driver miniport.

Filter penerima NDIS digunakan dalam antarmuka NDIS berikut:

NDIS Packet Coalescing. Untuk informasi selengkapnya tentang cara menggunakan filter penerima di antarmuka ini, lihat Mengelola Filter Penerimaan Coalescing Paket.
Virtualisasi I/O Akar Tunggal (SR-IOV). Untuk informasi selengkapnya tentang cara menggunakan filter penerima di antarmuka ini, lihat Mengatur Filter Terima pada Port Virtual.
Antrean Komputer Virtual (VMQ). Untuk informasi selengkapnya tentang cara menggunakan filter penerima di antarmuka ini, lihat Mengatur dan Menghapus Filter VMQ.

Sintaks

typedef struct _NDIS_RECEIVE_FILTER_INFO_ARRAY {
  NDIS_OBJECT_HEADER       Header;
  NDIS_RECEIVE_QUEUE_ID    QueueId;
  ULONG                    FirstElementOffset;
  ULONG                    NumElements;
  ULONG                    ElementSize;
  ULONG                    Flags;
  NDIS_NIC_SWITCH_VPORT_ID VPortId;
} NDIS_RECEIVE_FILTER_INFO_ARRAY, *PNDIS_RECEIVE_FILTER_INFO_ARRAY;

Anggota

Header

Jenis, revisi, dan ukuran struktur NDIS_RECEIVE_FILTER_INFO_ARRAY . 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_FILTER_INFO_ARRAY , driver harus mengatur anggota RevisiHeader ke nilai berikut:

NDIS_SIZEOF_RECEIVE_FILTER_INFO_ARRAY_REVISION_2

Menambahkan anggota untuk NDIS 6.30.

Atur anggota Ukuran ke NDIS_SIZEOF_RECEIVE_FILTER_INFO_ARRAY_REVISION_2.

NDIS_SIZEOF_RECEIVE_FILTER_INFO_ARRAY_REVISION_1

Versi asli untuk NDIS 6.20.

Atur anggota Ukuran ke NDIS_SIZEOF_RECEIVE_FILTER_INFO_ARRAY_REVISION_1.

QueueId

Pengidentifikasi antrean penerima. Pengidentifikasi ini adalah bilangan bulat antara nol dan jumlah antrean yang didukung adaptor jaringan. Nilai NDIS_DEFAULT_RECEIVE_QUEUE_ID menentukan antrean terima default.

Catatan Driver miniport yang mendukung coalescing paket NDIS atau antarmuka SR-IOV harus mengatur anggota QueueId ke NDIS_DEFAULT_RECEIVE_QUEUE_ID.

FirstElementOffset

Offset, dalam byte, ke elemen pertama dalam array elemen yang mengikuti struktur ini. Offset diukur dari awal struktur NDIS_RECEIVE_FILTER_INFO_ARRAY hingga awal elemen pertama. Setiap elemen dalam array adalah struktur NDIS_RECEIVE_FILTER_INFO .

Catatan Jika NumElements diatur ke nol, anggota ini diabaikan.

NumElements

Jumlah elemen dalam array.

ElementSize

Ukuran, dalam byte, dari setiap elemen dalam array.

Flags

Bitwise OR dari bendera berikut:

NDIS_RECEIVE_FILTER_INFO_ARRAY_VPORT_ID_SPECIFIED

Jika bendera ini diatur, informasi diminta tentang menerima filter yang dikonfigurasi pada port virtual (VPort) yang ditentukan oleh anggota VPortId .

Catatan Bendera ini hanya berlaku untuk antarmuka SR-IOV.

VPortId

Pengidentifikasi port virtual (VPort) tempat filter penerima dikueri. Pengidentifikasi VPort harus menjadi salah satu nilai berikut:

Pengidentifikasi VPort yang sebelumnya dialokasikan melalui permintaan metode OID OID_NIC_SWITCH_CREATE_VPORT.
Nilai NDIS_DEFAULT_VPORT_ID yang menentukan VPort default pada sakelar NIC.

Sakelar NIC didukung oleh adaptor jaringan untuk antarmuka SR-IOV. Sakelar NIC dapat dikonfigurasi untuk memiliki satu atau beberapa VPort.

Catatan Anggota VPortId hanya valid jika bendera NDIS_RECEIVE_FILTER_INFO_ARRAY_VPORT_ID_SPECIFIED diatur dalam Bendera.

Keterangan

Struktur NDIS_RECEIVE_FILTER_INFO_ARRAY digunakan dalam permintaan OID OID_RECEIVE_FILTER_ENUM_FILTERS. Permintaan OID ini menghitung filter terima pada antrean penerima VMQ atau SR-IOV. Setiap elemen dalam array yang mengikuti struktur NDIS_RECEIVE_FILTER_INFO_ARRAY adalah NDIS_RECEIVE_FILTER_INFO struktur.