OID_RECEIVE_FILTER_HARDWARE_CAPABILITIES

Artikel
06/15/2023

Driver yang terlalu berlebihan mengeluarkan permintaan kueri OID OID_RECEIVE_FILTER_HARDWARE_CAPABILITIES untuk mendapatkan kemampuan perangkat keras pemfilteran terima adaptor jaringan.

Setelah pengembalian berhasil dari permintaan kueri OID, anggota InformationBuffer dari struktur NDIS_OID_REQUEST berisi penunjuk ke strukturNDIS_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.

Struktur NDIS_RECEIVE_FILTER_CAPABILITIES berisi informasi tentang kemampuan perangkat keras pemfilteran terima adaptor jaringan. Kemampuan ini dapat mencakup kemampuan perangkat keras yang saat ini dinonaktifkan oleh pengaturan file INF atau melalui halaman Properti tingkat lanjut .

Catatan Semua kemampuan perangkat keras pemfilteran penerima adaptor jaringan dikembalikan melalui permintaan kueri OID OID_RECEIVE_FILTER_HARDWARE_CAPABILITIES, terlepas dari apakah kemampuan diaktifkan atau dinonaktifkan.

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 penerima.
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 .

Mengembalikan kode status

NDIS menangani permintaan kueri OID OID_RECEIVE_FILTER_HARDWARE_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 penanganan 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.