struktur WLAN_BSS_ENTRY (wlanapi.h)

Artikel
08/28/2023

Struktur WLAN_BSS_ENTRY berisi informasi tentang set layanan dasar (BSS).

Sintaks

typedef struct _WLAN_BSS_ENTRY {
  DOT11_SSID        dot11Ssid;
  ULONG             uPhyId;
  DOT11_MAC_ADDRESS dot11Bssid;
  DOT11_BSS_TYPE    dot11BssType;
  DOT11_PHY_TYPE    dot11BssPhyType;
  LONG              lRssi;
  ULONG             uLinkQuality;
  BOOLEAN           bInRegDomain;
  USHORT            usBeaconPeriod;
  ULONGLONG         ullTimestamp;
  ULONGLONG         ullHostTimestamp;
  USHORT            usCapabilityInformation;
  ULONG             ulChCenterFrequency;
  WLAN_RATE_SET     wlanRateSet;
  ULONG             ulIeOffset;
  ULONG             ulIeSize;
} WLAN_BSS_ENTRY, *PWLAN_BSS_ENTRY;

Anggota

dot11Ssid

SSID titik akses (AP) atau stasiun peer yang terkait dengan BSS. Jenis data untuk anggota ini adalah struktur DOT11_SSID .

uPhyId

Pengidentifikasi (ID) PHY yang digunakan antarmuka LAN nirkabel untuk mendeteksi jaringan BSS.

dot11Bssid

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

dot11BssType

Jenis jaringan BSS. Jenis data untuk anggota ini adalah nilai enumerasi DOT11_BSS_TYPE .

Anggota ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
dot11_BSS_type_infrastructure 1	Menentukan jaringan BSS infrastruktur.
dot11_BSS_type_independent 2	Menentukan jaringan BSS independen (IBSS) (jaringan ad hoc).

dot11BssPhyType

Tipe PHY untuk jaringan ini. Jenis data untuk anggota ini adalah nilai enumerasi DOT11_PHY_TYPE .

lRssi

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

uLinkQuality

Kualitas tautan yang dilaporkan oleh driver antarmuka LAN nirkabel. Nilai kualitas tautan berkisar antara 0 hingga 100. Nilai 100 menentukan kualitas tautan tertinggi.

bInRegDomain

Nilai yang menentukan apakah AP atau stasiun serekan beroperasi dalam domain peraturan seperti yang diidentifikasi oleh negara/wilayah.

Jika driver antarmuka LAN nirkabel tidak mendukung beberapa domain peraturan, anggota ini diatur ke TRUE.

Jika bingkai 802.11 Beacon atau Probe Response yang diterima dari AP atau stasiun peer tidak menyertakan elemen informasi Negara (IE), anggota ini diatur ke TRUE.

Jika bingkai 802.11 Beacon atau Probe Response yang diterima dari AP atau stasiun peer memang menyertakan IE Negara, anggota ini diatur ke FALSE jika nilai subbidang String Negara tidak sama dengan string negara input.

usBeaconPeriod

Nilai bidang Interval Suar dari bingkai Beacon atau Probe Response 802.11 yang diterima oleh antarmuka LAN nirkabel.

Interval berada dalam 1.024 unit waktu mikro detik antara waktu transmisi suar target. Informasi ini diambil dari paket suar yang dikirim oleh titik akses dalam jaringan BSS infrastruktur atau respons pemeriksaan dari titik akses atau stasiun peer sebagai respons terhadap klien LAN nirkabel yang mengirim Permintaan Probe.

Standar IEEE 802.11 mendefinisikan satuan waktu sama dengan 1.024 mikrodetik. Unit ini didefinisikan sehingga dapat dengan mudah diimplementasikan dalam perangkat keras.

ullTimestamp

Nilai bidang Tanda Waktu dari bingkai 802.11 Beacon atau Probe Response yang diterima oleh antarmuka LAN nirkabel.

ullHostTimestamp

Nilai tanda waktu host yang merekam ketika antarmuka LAN nirkabel menerima bingkai Beacon atau Probe Response. Anggota ini adalah hitungan interval 100 nanodetik sejak 1 Januari 1601.

Untuk informasi selengkapnya, lihat fungsi NdisGetCurrentSystemTime yang di dokumentasikan dalam WDK.

usCapabilityInformation

Nilai bidang Informasi Kemampuan dari bingkai 802.11 Beacon atau Probe Response yang diterima oleh antarmuka LAN nirkabel. Nilai ini adalah sekumpulan bendera bit yang menentukan kemampuan.

Anggota ini bisa menjadi satu atau beberapa nilai berikut.

Nilai	Makna
ESS bit 0	Set layanan yang diperluas. Satu set atau beberapa set layanan dasar (BSS) yang saling terhubung dan jaringan area lokal (LAN) terintegrasi yang muncul sebagai BSS tunggal ke lapisan kontrol tautan logis di stasiun mana pun yang terkait dengan salah satu BSS tersebut. AP mengatur subbidang ESS ke 1 dan subbidang IBSS ke 0 dalam bingkai Beacon atau Probe Response yang dikirimkan. Stasiun serekan dalam IBSS (jaringan ad hoc) mengatur subbidang ESS ke 0 dan subbidang IBSS ke 1 dalam bingkai Beacon atau Probe Response yang dikirimkan.
IBSS bit 1	Set layanan dasar independen. BSS yang membentuk jaringan mandiri, dan di mana tidak ada akses ke sistem distribusi (DS) yang tersedia (jaringan ad hoc). AP menetapkan subbidang ESS ke 1 dan subbidang IBSS ke 0 dalam bingkai Beacon atau Probe Response yang dikirimkan. Stasiun serekan dalam IBSS (jaringan ad hoc) mengatur subbidang ESS ke 0 dan subbidang IBSS ke 1 dalam bingkai Beacon atau Probe Response yang dikirimkan.
CF-Pollable bit 2	Nilai yang menunjukkan apakah AP atau stasiun serekan dapat dijajaki.
Permintaan Polling CF bit 3	Nilai yang menunjukkan bagaimana AP atau stasiun peer menangani permintaan polling.
Privasi bit 4	Nilai yang menunjukkan apakah enkripsi diperlukan untuk semua bingkai data. AP menetapkan subbidang Privasi ke 1 dalam bingkai Respons Suar dan Probe yang dikirimkan jika enkripsi WEP, WPA, atau WPA2 diperlukan untuk semua bingkai jenis data yang dipertukarkan dalam BSS. Jika enkripsi WEP, WPA, atau WPA2 tidak diperlukan, subbidang Privasi diatur ke 0. Stasiun serekan di dalam dan IBSS mengatur subbidang Privasi ke 1 dalam bingkai Respons Suar dan Probe yang dikirimkan jika enkripsi WEP, WPA, atau WPA2 diperlukan untuk semua bingkai jenis data yang dipertukarkan dalam IBSS. Jika enkripsi WEP, WPA, atau WPA2 tidak diperlukan, subbidang Privasi diatur ke 0.

ulChCenterFrequency

Frekuensi pusat saluran pita tempat bingkai Respons Suar atau Probe 802.11 diterima. Nilai ulChCenterFrequency berada dalam satuan kilohertz (kHz).

Catatan Anggota ini hanya berlaku untuk jenis PHY yang tidak memiliki spektrum spread hopping frekuensi (FHSS).

wlanRateSet

Sekumpulan tingkat transfer data yang didukung oleh BSS. Jenis data untuk anggota ini adalah struktur WLAN_RATE_SET .

ulIeOffset

Offset, dalam byte, dari blob data elemen informasi (IE) dari awal struktur WLAN_BSS_ENTRY .

Anggota ini menunjuk ke buffer yang berisi elemen informasi panjang variabel (IEs) dari bingkai 802.11 Beacon atau Probe Response. Untuk setiap BSS, IEs berasal dari bingkai Beacon atau Probe Response terakhir yang diterima dari jaringan BSS tersebut. Jika IE hanya tersedia dalam satu bingkai, driver antarmuka LAN nirkabel menggabungkan IE dengan IE lainnya dari bingkai Respons Suar atau Probe yang terakhir diterima.

Elemen informasi didefinisikan dalam spesifikasi IEEE 802.11 untuk memiliki format umum umum yang terdiri dari bidang ID Elemen 1-byte, bidang Panjang 1 byte, dan bidang informasi khusus elemen panjang variabel. Setiap elemen informasi diberi nilai ID Elemen unik seperti yang didefinisikan dalam standar IEEE 802.11 ini. Bidang Panjang menentukan jumlah byte di bidang informasi.

ulIeSize

Ukuran, dalam byte, dari blob data IE dalam struktur WLAN_BSS_ENTRY .

Ini adalah panjang data yang tepat dalam buffer yang ditunjukkan oleh anggota ulIeOffset dan tidak berisi padding apa pun untuk penyelarasan. Nilai maksimum untuk ukuran blob data IE adalah 2.324 byte.

Keterangan

Fungsi WlanGetNetworkBssList mengambil daftar BSS jaringan atau jaringan nirkabel pada antarmuka tertentu dan mengembalikan informasi ini dalam struktur WLAN_BSS_LIST yang berisi array . WLAN_BSS_ENTRY struktur.

Ketika antarmuka LAN nirkabel juga beroperasi sebagai Jaringan Yang Dihosting Nirkabel , daftar BSS akan berisi entri untuk BSS yang dibuat untuk Jaringan Yang Dihosting Nirkabel.

Karena informasi dikembalikan oleh titik akses untuk jaringan BSS infrastruktur atau oleh peer jaringan untuk jaringan BSS independen (jaringan ad hoc), informasi yang dikembalikan tidak boleh dipercaya. Anggota ulIeOffset dan ulIeSize dalam struktur WLAN_BSS_ENTRY harus digunakan untuk menentukan ukuran maksimum blob data elemen informasi dalam struktur WLAN_BSS_ENTRY , bukan data dalam blob data elemen informasi.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Header	wlanapi.h

Lihat juga

WLAN_AVAILABLE_NETWORK

WLAN_AVAILABLE_NETWORK_LIST

WLAN_BSS_LIST

WlanGetAvailableNetworkList

WlanGetNetworkBssList

Bagikan melalui