struktur DOT11_SCAN_REQUEST_V2 (windot11.h)
Struktur DOT11_SCAN_REQUEST_V2 menentukan parameter untuk operasi pemindaian eksplisit yang dilakukan oleh stasiun 802.11. Stasiun melakukan operasi pemindaian eksplisit setelah permintaan set OID OID_DOT11_SCAN_REQUEST.
Sintaks
typedef struct _DOT11_SCAN_REQUEST_V2 {
DOT11_BSS_TYPE dot11BSSType;
DOT11_MAC_ADDRESS dot11BSSID;
DOT11_SCAN_TYPE dot11ScanType;
BOOLEAN bRestrictedScan;
ULONG udot11SSIDsOffset;
ULONG uNumOfdot11SSIDs;
BOOLEAN bUseRequestIE;
ULONG uRequestIDsOffset;
ULONG uNumOfRequestIDs;
ULONG uPhyTypeInfosOffset;
ULONG uNumOfPhyTypeInfos;
ULONG uIEsOffset;
ULONG uIEsLength;
UCHAR ucBuffer[1];
} DOT11_SCAN_REQUEST_V2, *PDOT11_SCAN_REQUEST_V2;
Anggota
dot11BSSType
Jenis jaringan set layanan dasar (BSS) yang dipindai stasiun 802.11. Jenis data untuk anggota ini adalah enumerasi DOT11_BSS_TYPE .
dot11BSSID
Pengidentifikasi BSS (BSSID) dari jaringan BSS yang dipindai stasiun 802.11. Jika anggota ini diatur ke wildcard BSSID (0xFFFFFFFFFFFF), stasiun akan memindai semua BSSID.
dot11ScanType
Jenis pemindaian yang dilakukan stasiun 802.11. Jenis data untuk anggota ini adalah enumerasi DOT11_SCAN_TYPE, yang mendeklarasikan nilai berikut:
dot11_scan_type_active
Stasiun mengirimkan bingkai Permintaan Probe 802.11 pada setiap saluran yang dipindainya. Ini berdiam di saluran cukup lama untuk menerima bingkai Respons Probe 802.11 untuk Permintaan Probe-nya. Stasiun ini juga menerima 802.11 bingkai Beacon yang dikirim di saluran.
dot11_scan_type_passive
Stasiun tidak mengirimkan bingkai Permintaan Probe 802.11 pada setiap saluran yang dipindainya. Sebaliknya, ia menerima bingkai 802.11 Beacon atau Probe Request yang dikirim di saluran.
dot11_scan_type_auto
Stasiun dapat melakukan pemindaian aktif atau pasif, atau dapat menggunakan kombinasi kedua jenis pemindaian.
Terlepas dari nilai dot11ScanType, stasiun 802.11 harus melakukan jenis pemindaian dot11_scan_type_passive setiap kali memindai saluran yang tidak valid di domain peraturan saat ini. Selain itu, stasiun 802.11 harus melakukan jenis pemindaian dot11_scan_type_passive jika tidak memiliki domain peraturan default. Untuk informasi selengkapnya tentang domain peraturan, lihat OID_DOT11_CURRENT_REG_DOMAIN.
Jika bit dot11_scan_type_forced diatur dalam anggota dot11ScanType , stasiun 802.11 harus melakukan pemindaian lengkap di setiap saluran yang didukung. Jika bit dot11_scan_type_forced tidak diatur, stasiun 802.11 dapat melakukan pemindaian lengkap, atau dapat melakukan pemindaian parsial pada subset saluran yang didukung.
bRestrictedScan
Jika anggota ini TRUE, stasiun 802.11 melakukan pemindaian yang dibatasi untuk saluran dan konfigurasi PHY yang digunakan untuk terhubung ke jaringan BSS.
Driver miniport harus mengabaikan anggota ini jika salah satu hal berikut ini benar:
- Driver miniport beroperasi dalam mode ExtSTA.
- Stasiun 802.11 tidak terhubung ke jaringan BSS.
udot11SSIDsOffset
Offset dalam array ucBuffer tempat daftar pengidentifikasi set layanan (SSID) dimulai. Setiap entri dalam daftar SSID diformat sebagai struktur DOT11_SSID .
Stasiun 802.11 memindai setiap SSID dalam daftar. Misalnya, jika dot11ScanType diatur ke dot11_scan_type_active, stasiun 802.11 mengirimkan Permintaan Probe 802.11 untuk setiap SSID dalam daftar saat memindai di saluran.
uNumOfdot11SSIDs
Jumlah entri dalam daftar SSID.
Jika uNumOfdot11SSIDs nol, driver miniport harus menggunakan daftar SSID yang berisi SSID panjang nol kartubebas.
bUseRequestIE
Jika anggota ini TRUE, stasiun 802.11 harus menyertakan daftar ID permintaan (ditentukan melalui anggota uRequestIDsOffset dan uNumOfRequestIDs ) dalam elemen informasi permintaan (IE) 802.11d dari setiap bingkai Permintaan Probe yang dikirimkannya selama pemindaian aktif.
Driver miniport harus mengabaikan anggota ini (bersama dengan anggota uRequestIDsOffset dan uNumOfRequestIDs ) jika salah satu hal berikut ini benar:
- Driver miniport beroperasi dalam mode ExtSTA.
- Objek 802.11 dot11MultiDomainCapabilityEnabled management information base (MIB) adalah FALSE. Untuk informasi selengkapnya tentang objek MIB dot11MultiDomainCapabilityEnabled , lihat OID_DOT11_MULTI_DOMAIN_CAPABILITY_ENABLED.
- Anggota dot11ScanType diatur ke dot11_scan_type_passive.
uRequestIDsOffset
Offset dalam array ucBuffer tempat daftar ID Permintaan dimulai. Setiap entri dalam daftar ID permintaan diformat sebagai jenis data UCHAR.
uNumOfRequestIDs
Jumlah entri dalam daftar ID permintaan.
uPhyTypeInfosOffset
Offset dalam array ucBuffer tempat daftar jenis PHY dimulai. Setiap entri dalam daftar jenis PHY diformat sebagai struktur DOT11_PHY_TYPE_INFO .
Stasiun 802.11 harus melakukan pemindaian BSS dengan menggunakan masing-masing jenis PHY yang ditentukan dari daftar ini.
Driver miniport harus mengabaikan anggota ini (bersama dengan anggota uNumOfPhyTypeInfos ) jika bRestrictedScan diatur ke TRUE.
uNumOfPhyTypeInfos
Jumlah entri dalam daftar jenis PHY.
Jika uNumOfPhyTypeInfos adalah nol, stasiun 802.11 melakukan pemindaian menggunakan semua PHY yang didukung.
uIEsOffset
Offset dalam array ucBuffer tempat daftar elemen informasi panjang variabel (IEs) dimulai. Stasiun 802.11 harus menambahkan daftar IEs ke akhir setiap bingkai Permintaan Probe yang dikirimkannya selama pemindaian aktif.
Driver miniport harus mengabaikan anggota ini (bersama dengan anggota uIEsLength ) jika dot11ScanType diatur ke dot11_scan_type_passive.
uIEsLength
Panjangnya, dalam byte, dari daftar IEs.
ucBuffer[1]
Buffer yang berisi data opsional seperti yang ditentukan melalui anggota lain dari struktur ini.
Keterangan
Stasiun 802.11 melakukan operasi pemindaian eksplisit setelah permintaan set OID OID_DOT11_SCAN_REQUEST. Stasiun melakukan operasi pemindaian dengan menggunakan parameter yang ditentukan melalui DOT11_SCAN_REQUEST_V2, yang menyertai permintaan yang ditetapkan.
Untuk informasi selengkapnya tentang operasi pemindaian yang dilakukan oleh driver miniport Native 802.11, lihat Operasi Pemindaian Native 802.11.
Untuk informasi selengkapnya tentang mode operasi ExtSTA, lihat Mode Operasi Stasiun yang Dapat Diperluas.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Tersedia di Windows Vista dan versi yang lebih baru dari sistem operasi Windows. |
| Header | windot11.h (termasuk Ndis.h) |
Lihat juga
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk