OID_RECEIVE_FILTER_CURRENT_CAPABILITIES

Artikel
06/15/2023

Driver yang terlalu berlebihan mengeluarkan permintaan kueri OID dari OID_RECEIVE_FILTER_CURRENT_CAPABILITIES untuk mendapatkan kemampuan pemfilteran terima yang saat ini diaktifkan dari adaptor jaringan.

Setelah pengembalian berhasil dari permintaan kueri OID, anggota InformationBuffer dari struktur NDIS_OID_REQUEST berisi penunjuk ke struktur NDIS_RECEIVE_FILTER_CAPABILITIES .

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.

Dimulai dengan NDIS 6.20, driver miniport mendaftarkan kemampuan perangkat keras pemfilteran terima yang saat ini diaktifkan dari adaptor jaringan ketika fungsi MiniportInitializeEx-nya dipanggil. Driver miniport mendaftarkan kemampuan ini dengan mengikuti langkah-langkah berikut:

Driver menginisialisasi struktur NDIS_RECEIVE_FILTER_CAPABILITIES dengan kemampuan perangkat keras pemfilteran terima yang saat ini diaktifkan.
Driver menginisialisasi struktur NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES dan mengatur anggota CurrentReceiveFilterCapabilities ke penunjuk ke struktur NDIS_RECEIVE_FILTER_CAPABILITIES .
Driver miniport memanggil fungsi NdisMSetMiniportAttributes dan mengatur parameter MiniportAttributes ke pointer ke struktur NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES .

Protokol yang terlalu berlebihan dan driver filter tidak perlu mengeluarkan permintaan kueri OID OID_RECEIVE_FILTER_CURRENT_CAPABILITIES. NDIS menyediakan kemampuan pemfilteran terima yang saat ini diaktifkan kepada driver ini dengan cara berikut:

NDIS menyediakan kemampuan pemfilteran terima yang saat ini diaktifkan dari adaptor jaringan yang mendasarinya ke driver protokol yang terlalu berlebihan di anggota ReceiveFilterCapabilities dari struktur NDIS_BIND_PARAMETERS selama operasi pengikatan.
NDIS menyediakan kemampuan pemfilteran terima yang saat ini diaktifkan dari adaptor jaringan yang mendasarinya ke driver filter yang terlalu berlebihan di anggota ReceiveFilterCapabilities dari struktur NDIS_FILTER_ATTACH_PARAMETERS selama operasi lampirkan.

Mengembalikan kode status

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

NDIS_STATUS_SUCCESS
Permintaan berhasil diselesaikan. InformationBuffer menunjuk ke struktur NDIS_RECEIVE_FILTER_CAPABILITIES.

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_NOT_SUPPORTED
Adapter jaringan tidak mendukung pemfilteran penerimaan.

NDIS_STATUS_FAILURE
Permintaan gagal karena alasan lain.