struktur DOT11_BSS_ENTRY (windot11.h)

Artikel
03/05/2024

Penting Antarmuka LAN Nirkabel Native 802.11 tidak digunakan lagi di Windows 10 dan yang lebih baru. Silakan gunakan WLAN Device Driver Interface (WDI) sebagai gantinya. Untuk informasi selengkapnya tentang WDI, lihat WLAN Universal Windows driver model.

Struktur DOT11_BSS_ENTRY mendefinisikan IEEE 802.11 Beacon atau Response Frame yang diterima stasiun 802.11 selama operasi pemindaian terakhirnya.

Sintaks

typedef struct DOT11_BSS_ENTRY {
  ULONG                             uPhyId;
  DOT11_BSS_ENTRY_PHY_SPECIFIC_INFO PhySpecificInfo;
  DOT11_MAC_ADDRESS                 dot11BSSID;
  DOT11_BSS_TYPE                    dot11BSSType;
  LONG                              lRSSI;
  ULONG                             uLinkQuality;
  BOOLEAN                           bInRegDomain;
  USHORT                            usBeaconPeriod;
  ULONGLONG                         ullTimestamp;
  ULONGLONG                         ullHostTimestamp;
  USHORT                            usCapabilityInformation;
  ULONG                             uBufferLength;
  UCHAR                             ucBuffer[1];
} DOT11_BSS_ENTRY, *PDOT11_BSS_ENTRY;

Anggota

uPhyId

Pengidentifikasi (ID) PHY yang digunakan stasiun 802.11 untuk mendeteksi jaringan BSS. ID PHY adalah indeks dalam daftar PHY yang didukung yang dikembalikan oleh driver melalui kueri OID_DOT11_SUPPORTED_PHY_TYPES.

ID ini tidak boleh DOT11_PHY_ID_ANY.

PhySpecificInfo

Atribut PHY yang dirujuk oleh anggota uPhyId . PhySpecificInfo diformat sebagai DOT11_BSS_ENTRY_PHY_SPECIFIC_INFO serikat.

dot11BSSID

Alamat kontrol akses media (MAC) dari titik akses (AP) (untuk jaringan BSS infrastruktur) atau stasiun serekan (untuk jaringan BSS independen) yang mengirim bingkai Beacon atau Probe Response 802.11 yang diterima oleh stasiun 802.11 saat memindai. Jenis data untuk anggota ini adalah struktur DOT11_MAC_ADDRESS .

dot11BSSType

Jenis jaringan BSS.

Jenis data untuk anggota ini adalah enumerasi DOT11_BSS_TYPE . Driver miniport tidak boleh mengatur anggota ini ke nilai dot11_BSS_type_any .

lRSSI

Nilai indikator kekuatan sinyal (RSSI) yang diterima, dalam satuan desibel yang dirujuk ke 1,0 miliwatt (dBm), seperti yang terdeteksi oleh stasiun 802,11 untuk AP atau stasiun peer.

uLinkQuality

Nilai kualitas tautan mulai dari 0 hingga 100. Nilai 100 menentukan kualitas tautan tertinggi. Untuk informasi selengkapnya tentang menentukan kualitas tautan, lihat Menautkan Operasi Kualitas.

bInRegDomain

Anggota ini menentukan apakah AP atau stasiun serekan beroperasi dalam domain peraturan seperti yang diidentifikasi oleh string negara input. Untuk mengatur anggota ini, driver miniport harus menggunakan panduan berikut:

Jika stasiun 802.11 tidak mendukung beberapa domain peraturan, atur anggota ke TRUE. Untuk informasi selengkapnya tentang beberapa domain peraturan, lihat OID_DOT11_MULTI_DOMAIN_CAPABILITY_IMPLEMENTED.
Jika string negara input adalah semua nol, atur anggota ke TRUE.
Jika AP atau stasiun serekan tidak beroperasi pada saluran yang valid untuk domain peraturan yang ditentukan oleh string negara input, atur anggota ke FALSE.
Jika bingkai Beacon atau Probe Response 802.11, yang diterima dari AP atau stasiun serekan, tidak menyertakan elemen informasi Negara (IE), atur anggota ke TRUE.
Untuk informasi selengkapnya tentang IE Negara, lihat Klausul 7.3.2.12 dari standar IEEE 802.11d-2001.
Jika bingkai Beacon atau Probe Response 802.11, yang diterima dari STASIUN AP atau serekan, memang menyertakan IE Negara, atur anggota ke FALSE jika nilai subbidang String Negara tidak sama dengan string negara input.
Atur anggota ke TRUE dalam semua kasus lainnya.

usBeaconPeriod

Nilai bidang Interval Suar dari bingkai Suar 802.11 atau Respons Probe.

ullTimestamp

Nilai bidang Tanda Waktu dari bingkai Suar 802.11 atau Respons Probe.

ullHostTimestamp

Tanda waktu, diselesaikan melalui panggilan ke NdisGetCurrentSystemTime, yang mencatat ketika stasiun 802.11 menerima bingkai Beacon atau Probe Response 802.11.

usCapabilityInformation

Nilai bidang Informasi Kemampuan dari bingkai Beacon atau Probe Response 802.11.

uBufferLength

Panjangnya, dalam byte, dari array ucBuffer dalam struktur DOT11_BSS_ENTRY. ulBufferLength harus memiliki panjang data yang tepat dalam array ucBuffer dan tidak boleh berisi padding apa pun untuk penyelarasan.

ucBuffer[1]

Elemen informasi panjang variabel (IEs) dari bingkai Beacon atau Probe Response 802.11. Untuk setiap BSS, IEs harus berasal dari bingkai Beacon atau Probe Response terakhir yang diterima dari jaringan BSS tersebut. Jika IE hanya tersedia dalam satu bingkai, driver miniport harus menggabungkan IE dengan IE lainnya dari bingkai Respons Suar atau Probe yang terakhir diterima.

Ketika NIC berada dalam mode OP Extensible Access Point (ExtAP), daftar BSS harus berisi entri untuk BSS yang dibuat NIC.

Untuk informasi selengkapnya tentang bidang dalam bingkai IEEE 802.11 Beacon atau Probe Response, lihat Klausul 8.4 dari standar IEEE 802.11-2012.

Keterangan

Ketika stasiun 802.11 melakukan operasi pemindaian, driver miniport Native 802.11 menyimpan bingkai Respons Suar dan Probe 802.11 yang diterima. Untuk informasi selengkapnya tentang operasi pemindaian, lihat Operasi Pemindaian Asli 802.11.

Setelah stasiun 802.11 menyelesaikan operasi pemindaian, pengemudi miniport mengembalikan daftar bingkai Respons Suar dan Probe yang di-cache saat dikueri oleh OID_DOT11_ENUM_BSS_LIST. Struktur DOT11_BSS_ENTRY terpisah diformat untuk setiap bingkai Beacon dan Probe Response.