NDIS_STATUS_RECEIVE_FILTER_CURRENT_CAPABILITIES
Driver miniport mengeluarkan indikasi status NDIS_STATUS_RECEIVE_FILTER_CURRENT_CAPABILITIES ketika saat ini diaktifkan menerima kemampuan pemfilteran berubah.
Catatan Indikasi status ini hanya boleh dibuat oleh driver miniport yang mendukung NDIS menerima filter.
Ketika driver miniport membuat indikasi status ini, ia mengatur anggota StatusBuffer dari struktur NDIS_STATUS_INDICATION ke penunjuk ke struktur NDIS_RECEIVE_FILTER_CAPABILITIES . Driver menginisialisasi struktur ini dengan kemampuan filter terima yang saat ini diaktifkan.
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 miniport mengeluarkan indikasi status NDIS_STATUS_RECEIVE_FILTER_CURRENT_CAPABILITIES ketika salah satu kondisi berikut ini benar:
Kemampuan filter terima yang saat ini diaktifkan berubah pada satu adaptor jaringan. Misalnya, filter penerimaan dapat diaktifkan atau dinonaktifkan melalui aplikasi manajemen yang dikembangkan oleh vendor perangkat keras independen (IHV).
Kemampuan filter terima yang diaktifkan saat ini berubah untuk satu atau beberapa adaptor jaringan yang termasuk dalam tim load balancing failover (LBFO) yang dikelola oleh driver perantara MUX. Untuk informasi selengkapnya, lihat Driver Perantara NDIS MUX.
Driver miniport mengikuti langkah-langkah ini ketika mengeluarkan indikasi status NDIS_STATUS_RECEIVE_FILTER_CURRENT_CAPABILITIES :
Miniport menginisialisasi struktur NDIS_RECEIVE_FILTER_CAPABILITIES dengan kemampuan filter terima yang saat ini diaktifkan pada adaptor jaringan.
Ketika driver miniport menginisialisasi anggota Header , driver tersebut mengatur anggota JenisHeader ke NDIS_OBJECT_TYPE_DEFAULT. Driver miniport mengatur anggota RevisiHeader ke NDIS_RECEIVE_FILTER_CAPABILITIES_REVISION_2 dan anggota Ukuran ke NDIS_SIZEOF_RECEIVE_FILTER_CAPABILITIES_REVISION_2.
Driver miniport menginisialisasi struktur NDIS_STATUS_INDICATION untuk indikasi status dengan cara berikut:
Anggota StatusCode harus diatur ke NDIS_STATUS_RECEIVE_FILTER_CURRENT_CAPABILITIES.
Anggota StatusBuffer harus diatur ke alamat struktur NDIS_RECEIVE_FILTER_CAPABILITIES .
Anggota StatusBufferSize harus diatur ke
sizeof(NDIS_RECEIVE_FILTER_CAPABILITIES).
Driver miniport mengeluarkan indikasi status dengan memanggil NdisMIndicateStatusEx. Driver harus meneruskan penunjuk ke struktur NDIS_STATUS_INDICATION ke parameter StatusIndication .
Catatan Driver yang terlalu berlebihan dapat menggunakan indikasi status NDIS_STATUS_RECEIVE_FILTER_CURRENT_CAPABILITIES untuk menentukan kemampuan filter penerima adaptor jaringan yang saat ini diaktifkan. Atau, driver ini juga dapat mengeluarkan permintaan kueri OID OID_RECEIVE_FILTER_CURRENT_CAPABILITIES untuk mendapatkan kemampuan filter terima yang saat ini diaktifkan kapan saja.
Persyaratan
Versi |
Didukung di NDIS 6.30 dan yang lebih baru. |
Header |
Ndis.h (termasuk Ndis.h) |