OID_GEN_CURRENT_PACKET_FILTER
Sebagai kueri, OID_GEN_CURRENT_PACKET_FILTER OID melaporkan jenis paket bersih yang menerima indikasi dari driver miniport.
Sebagai satu set, OID_GEN_CURRENT_PACKET_FILTER OID menentukan jenis paket bersih tempat protokol menerima indikasi dari driver miniport.
Informasi Versi
Windows Vista dan versi Windows yang lebih baru
Didukung.
Driver miniport NDIS 6.0 dan yang lebih baru
Wajib. (lihat bagian Keterangan)
Driver miniport NDIS 5.1
Wajib.
Driver miniport NDIS 5.1
Wajib.
Keterangan
Untuk driver miniport NDIS 6.0 dan yang lebih baru, kueri tidak diminta dan set adalah wajib. NDIS menangani kueri untuk driver miniport. Driver miniport melaporkan informasi filter paket selama inisialisasi.
Driver miniport melaporkan jenis sedangnya sebagai salah satu yang sistemnya menyediakan pustaka filter. Filter paket menggunakan operasi OR untuk menggabungkan jenis berikut secara inklusif:
NDIS_PACKET_TYPE_DIRECTED
Paket yang diarahkan. Paket yang diarahkan berisi alamat tujuan yang sama dengan alamat stasiun NIC.
NDIS_PACKET_TYPE_MULTICAST
Paket alamat multicast dikirim ke alamat dalam daftar alamat multicast.
Driver protokol dapat menerima paket multicast Ethernet (802.3) dengan menentukan jenis paket alamat multicast atau fungsional. Mengatur daftar alamat multicast atau alamat fungsional menentukan grup alamat multicast mana yang diaktifkan driver NIC.
NDIS_PACKET_TYPE_ALL_MULTICAST
Semua paket alamat multicast, bukan hanya paket yang dijumlahkan dalam daftar alamat multicast.
NDIS_PACKET_TYPE_BROADCAST
Paket siaran.
NDIS_PACKET_TYPE_PROMISCUOUS
Menentukan semua paket terlepas dari apakah pemfilteran VLAN diaktifkan atau tidak dan apakah pengidentifikasi VLAN cocok atau tidak.
NDIS_PACKET_TYPE_ALL_FUNCTIONAL
Semua paket alamat fungsi, bukan hanya yang ada di alamat fungsi saat ini.
NDIS_PACKET_TYPE_ALL_LOCAL
Semua paket yang dikirim oleh protokol yang diinstal dan semua paket yang ditunjukkan oleh NIC yang diidentifikasi oleh NdisBindingHandle tertentu.
NDIS_PACKET_TYPE_FUNCTIONAL
Paket alamat fungsi yang dikirim ke alamat yang disertakan dalam alamat fungsi saat ini.
NDIS_PACKET_TYPE_GROUP
Paket dikirim ke alamat grup saat ini.
NDIS_PACKET_TYPE_MAC_FRAME
Driver NIC membingkai yang diterima Token Ring NIC.
NDIS_PACKET_TYPE_SMT
Paket SMT yang diterima FDDI NIC.
NDIS_PACKET_TYPE_SOURCE_ROUTING
Semua paket perutean sumber. Jika driver protokol mengatur bit ini, pustaka NDIS mencoba bertindak sebagai jembatan perutean sumber.
Untuk adaptor miniport yang jenis medianya NdisMedium802_3 atau NdisMedium802_5, NDIS menonaktifkan penerimaan paket, bersama dengan alamat multicast dan fungsional selama panggilan ke fungsi NdisOpenAdapterEx .
Untuk adaptor miniport dengan semua jenis media lainnya, driver protokol dapat mulai menerima paket kapan saja selama panggilan NdisOpenAdapterEx . Perhatikan bahwa protokol bahkan dapat menerima paket sebelum NdisOpenAdapterEx kembali. Secara umum, pemfilteran paket adalah upaya terbaik, dan driver protokol harus siap untuk menangani indikasi terima bahkan ketika filter paket nol.
Untuk kueri, NDIS mengembalikan filter pengikatan yang digabungkan menggunakan operator OR.
Untuk satu set, filter paket yang ditentukan menggantikan filter paket sebelumnya untuk pengikatan. Jika driver miniport sebelumnya mengaktifkan jenis paket tetapi driver protokol tidak menentukan tipe tersebut dalam filter baru, driver protokol tidak akan menerima paket jenis ini.
Untuk adaptor miniport yang jenis medianya NdisMedium802_3 atau NdisMedium802_5, jika driver miniport tidak mengatur sedikit untuk jenis paket tertentu sebagai respons terhadap kueri ini, driver protokol tidak akan menerima paket jenis tersebut. Akibatnya, driver protokol dapat menonaktifkan penerimaan paket dengan memanggil fungsi NdisOidRequest atau NdisCoOidRequest menggunakan filter nol.
Untuk adaptor miniport dengan semua jenis media lainnya, NDIS tidak memeriksa jenis paket. Untuk jenis media ini, driver protokol tidak dapat menonaktifkan penerimaan paket dengan menentukan filter nol.
Ketika fungsi MiniportInitializeEx driver miniport dipanggil, filter paket driver miniport harus diatur ke nol. Ketika filter paket nol, indikasi terima dinonaktifkan. Setelah fungsi MiniportInitializeEx driver miniport kembali, driver protokol dapat mengatur OID_GEN_CURRENT_PACKET_FILTER ke nilai bukan nol, sehingga memungkinkan driver miniport untuk menunjukkan paket yang diterima ke protokol tersebut.
Jika mode promiscuous diaktifkan dengan bit NDIS_PACKET_TYPE_PROMISCUOUS, driver protokol terus menerima paket bahkan jika simpul jaringan pengiriman tidak mengarahkannya ke sana. NDIS kemudian mengirim driver protokol semua paket yang diterima NIC.
Mengatur filter paket tertentu tidak mengubah filter paket untuk driver protokol lain yang terikat ke (atau di atasnya) NIC yang sama. Misalnya, jika satu protokol terikat memungkinkan mode promiscuous, driver protokol terikat lainnya tidak menerima paket yang belum mereka minta secara khusus dengan filter paket mereka sendiri.
Filter Paket Asli 802.11
Driver miniport Native 802.11 hanya boleh mendukung jenis filter paket standar berikut:
NDIS_PACKET_TYPE_DIRECTED
NDIS_PACKET_TYPE_MULTICAST
NDIS_PACKET_TYPE_BROADCAST
NDIS_PACKET_TYPE_PROMISCUOUS
Saat diaktifkan, filter paket standar ini hanya berlaku untuk paket data 802.11.
Selain itu, driver miniport Native 802.11 harus mendukung jenis filter paket berikut, yang khusus untuk media Native 802.11:
NDIS_PACKET_TYPE_802_11_RAW_DATA
Bingkai unit data protokol kontrol akses media (MAC) 802.11 (MPDU), yang berisi semua data dalam format yang diterima oleh stasiun 802.11. Ketika filter ini diatur, driver harus menunjukkan setiap fragmen MPDU yang tidak dimodifikasi sebelum menunjukkan paket unit data layanan MAC (MSDU) yang disusun kembali dari fragmen MPDU.
Jika fragmen MPDU dienkripsi, fragmen tidak boleh mendekripsi fragmen sebelum ditunjukkan. Namun, driver miniport harus mendekripsi setiap fragmen MPDU sebelum menyusun ulang dan menunjukkan paket MSDU.
Jika diaktifkan, jenis filter ini hanya memengaruhi filter paket standar lainnya, seperti NDIS_PACKET_TYPE_DIRECTED atau NDIS_PACKET_TYPE_BROADCAST.
Untuk informasi selengkapnya tentang metode untuk menunjukkan paket data mentah 802.11, lihat Menunjukkan Paket Mentah 802.11.
NDIS_PACKET_TYPE_802_11_DIRECTED_MGMT
Mengarahkan paket manajemen 802.11. Paket yang diarahkan berisi alamat tujuan yang sama dengan alamat stasiun NIC.
NDIS_PACKET_TYPE_802_11_MULTICAST_MGMT
Paket manajemen Multicast 802.11 yang dikirim ke alamat dalam daftar alamat multicast.
NDIS_PACKET_TYPE_802_11_ALL_MULTICAST_MGMT
Semua paket manajemen multicast 802.11 yang diterima oleh stasiun 802.11, terlepas dari apakah alamat tujuan di header MAC 802.11 ada dalam daftar alamat multicast.
NDIS_PACKET_TYPE_802_11_BROADCAST_MGMT
Menyiarkan paket manajemen 802.11 yang diterima oleh stasiun 802.11.
NDIS_PACKET_TYPE_802_11_PROMISCUOUS_MGMT
Semua paket manajemen 802.11 diterima oleh stasiun 802.11.
NDIS_PACKET_TYPE_802_11_RAW_MGMT
Bingkai manajemen MPDU 802.11, yang berisi semua data dalam format yang diterima oleh stasiun 802.11. Ketika filter ini diatur, driver harus menunjukkan setiap fragmen MPDU yang tidak dimodifikasi sebelum menunjukkan paket unit data protokol manajemen MAC (MMPDU) yang disusun kembali dari fragmen MPDU.
Jika diaktifkan, jenis filter ini hanya memengaruhi filter paket manajemen 802.11 lainnya, seperti NDIS_PACKET_TYPE_802_11_DIRECTED_MGMT atau NDIS_PACKET_TYPE_802_11_MULTICAST_MGMT.
Untuk informasi selengkapnya tentang metode untuk menunjukkan paket manajemen 802.11 mentah, lihat Menunjukkan Paket Raw 802.11.
NDIS_PACKET_TYPE_802_11_DIRECTED_CTRL
Paket kontrol 802.11 yang diarahkan. Paket yang diarahkan berisi alamat tujuan yang sama dengan alamat stasiun NIC.
NDIS_PACKET_TYPE_802_11_BROADCAST_CTRL
Siaran 802.11 paket kontrol diterima oleh stasiun 802.11.
NDIS_PACKET_TYPE_802_11_PROMISCUOUS_CTRL
Semua paket kontrol 802.11 diterima oleh stasiun 802.11.
Jika driver miniport beroperasi dalam mode Native 802.11 Network Monitor (NetMon) atau Extensible Access Point (AP), driver harus mengaktifkan filter paket berikut melalui permintaan set OID_GEN_CURRENT_PACKET_FILTER.
NDIS_PACKET_TYPE_PROMISCUOUS
NDIS_PACKET_TYPE_802_11_RAW_DATA
NDIS_PACKET_TYPE_802_11_PROMISCUOUS_MGMT
NDIS_PACKET_TYPE_802_11_RAW_MGMT
NDIS_PACKET_TYPE_802_11_PROMISCUOUS_CTRL
Driver miniport yang beroperasi dalam mode Native 802.11 lainnya selain NetMon tidak boleh mengaktifkan pengaturan filter paket ini, dengan pengecualian NDIS_PACKET_TYPE_802_11_PROMISCUOUS_CTRL. Driver miniport yang tidak beroperasi dalam mode NetMon dapat secara opsional mengaktifkan NDIS_PACKET_TYPE_802_11_PROMISCUOUS_CTRL melalui permintaan set OID_GEN_CURRENT_PACKET_FILTER.
Catatan Ketika driver miniport berada dalam mode Native 802.11 selain NetMon, dan OID_GEN_CURRENT_PACKET_FILTER diatur, driver tidak boleh gagal dalam permintaan yang ditetapkan jika ada pengaturan promiscuous atau filter mentah yang diaktifkan dalam data OID.
Untuk informasi selengkapnya tentang mode operasi NetMon dan ExtAP, lihat topik berikut:
Mode Operasi Titik Akses yang Dapat Diperluas
Persyaratan
Header |
Ntddndis.h (termasuk Ndis.h) |