OID_RECEIVE_FILTER_ENUM_FILTERS

Artikel
06/15/2023

Driver yang terlalu berlebihan mengeluarkan permintaan metode OID OID_RECEIVE_FILTER_ENUM_FILTERS untuk mendapatkan daftar semua filter yang dikonfigurasi pada adaptor jaringan.

Anggota InformationBuffer dari struktur NDIS_OID_REQUEST berisi penunjuk ke struktur NDIS_RECEIVE_FILTER_INFO_ARRAY .

Setelah pengembalian berhasil dari permintaan metode OID, anggota InformationBuffer dari struktur NDIS_OID_REQUEST berisi penunjuk ke buffer. Buffer ini diformat untuk memuat hal berikut:

Struktur NDIS_RECEIVE_FILTER_INFO_ARRAY yang menentukan daftar filter terima yang saat ini dikonfigurasi pada driver miniport.
Array struktur NDIS_RECEIVE_FILTER_INFO . Setiap struktur menentukan parameter filter terima yang saat ini dikonfigurasi pada driver miniport.

Keterangan

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.

Driver atau aplikasi yang terlalu berlebihan mengeluarkan permintaan metode OID OID_RECEIVE_FILTER_ENUM_FILTERS untuk menghitung filter terima yang diatur pada adaptor jaringan. Ini termasuk menerima filter yang diatur pada port virtual SR-IOV (VPort) atau antrean penerima VMQ.

Panduan Tambahan untuk Antarmuka Coalescing Paket NDIS

Dimulai dengan Windows Server 2012, penggalian paket NDIS hanya mendukung antrean penerima default adaptor jaringan.

Untuk menghitung filter penerima coalescing paket, driver yang terlalu berlebihan harus mengatur anggota QueueId dari struktur NDIS_RECEIVE_FILTER_INFO_ARRAY ke NDIS_DEFAULT_RECEIVE_QUEUE_ID.

Panduan Tambahan untuk Antarmuka SR-IOV

Dimulai dengan Windows Server 2012, antarmuka SR-IOV hanya mendukung antrean penerima default port virtual (VPort).

Untuk menghitung filter penerima VPort, driver yang terlalu berlebihan harus mengatur anggota QueueId dari struktur NDIS_RECEIVE_FILTER_INFO_ARRAY ke NDIS_DEFAULT_RECEIVE_QUEUE_ID.

Panduan Tambahan untuk Antarmuka VMQ

Driver yang terlalu berlebihan dapat mengeluarkan permintaan metode OID OID_RECEIVE_FILTER_ENUM_FILTERS untuk menghitung filter terima yang diatur pada antrean penerima VMQ. Saat driver yang terlalu berlebihan menginisialisasi struktur NDIS_RECEIVE_FILTER_INFO_ARRAY , driver tersebut mengatur anggota QueueId ke salah satu nilai berikut:

Nilai pengidentifikasi antrean untuk antrean penerima nondefault. Driver yang terlalu berlebihan memperoleh nilai input pengidentifikasi antrean dari permintaan metode OID sebelumnya OID_RECEIVE_FILTER_ALLOCATE_QUEUE atau permintaan kueri OID OID_RECEIVE_FILTER_ENUM_QUEUES.
Nilai pengidentifikasi antrean NDIS_DEFAULT_RECEIVE_QUEUE_ID, yang menentukan antrean terima default.

Mengembalikan kode status

NDIS menangani permintaan metode OID OID_RECEIVE_FILTER_ENUM_FILTERS untuk driver miniport, dan mengembalikan salah satu kode status berikut:

NDIS_STATUS_SUCCESS
Permintaan berhasil diselesaikan. InformationBuffer menunjuk ke struktur NDIS_RECEIVE_FILTER_INFO_ARRAY.

NDIS_STATUS_PENDING
Permintaan tertunda penyelesaiannya. NDIS meneruskan kode status akhir dan hasil ke handler penyelesaian permintaan OID dari pemanggil setelah permintaan selesai.

NDIS_STATUS_INVALID_LENGTH
Buffer informasi terlalu pendek. NDIS mengatur DATA. QUERY_INFORMATION. Anggota BytesNeeded dalam struktur NDIS_OID_REQUEST ke ukuran buffer minimum yang diperlukan.

NDIS_STATUS_FAILURE
Permintaan gagal karena alasan lain.