OID_RECEIVE_FILTER_PARAMETERS

Artikel
06/15/2023

Driver yang terlalu berlebihan mengeluarkan permintaan metode OID OID_RECEIVE_FILTER_PARAMETERS untuk mendapatkan parameter konfigurasi filter saat ini pada adaptor jaringan.

Anggota InformationBuffer dari struktur NDIS_OID_REQUEST berisi penunjuk ke struktur NDIS_RECEIVE_FILTER_PARAMETERS . NDIS menggunakan anggota FilterId dalam struktur input untuk mengidentifikasi filter.

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_PARAMETERS yang menentukan parameter untuk filter penerima NDIS.
Array struktur NDIS_RECEIVE_FILTER_FIELD_PARAMETERS yang menentukan kriteria pengujian filter untuk bidang di header paket jaringan.

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 yang terlalu berlebihan mengeluarkan permintaan metode OID OID_RECEIVE_FILTER_PARAMETERS untuk mendapatkan parameter konfigurasi untuk filter terima yang diatur pada adaptor jaringan. Ini termasuk filter terima yang diatur pada VMQ menerima antrean atau port virtual SR-IOV (VPort), serta filter penggabungan paket yang diunduh ke driver miniport.

Driver yang terlalu berlebihan memperoleh pengidentifikasi filter dari permintaan metode OID sebelumnya OID_RECEIVE_FILTER_SET_FILTER atau dari permintaan OID OID_RECEIVE_FILTER_ENUM_FILTERS.

Mengembalikan kode status

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

NDIS_STATUS_SUCCESS
Permintaan berhasil diselesaikan. InformationBuffer menunjuk ke struktur NDIS_RECEIVE_FILTER_PARAMETERS.

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

NDIS_STATUS_INVALID_PARAMETER
Driver atau aplikasi yang terlalu berlebihan menyediakan pengidentifikasi filter yang tidak valid. Pengidentifikasi filter tidak valid jika nol atau jika menentukan filter yang tidak terdefinisi.

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.