WLAN_BSS_ENTRY struttura (wlanapi.h)
La struttura WLAN_BSS_ENTRY contiene informazioni su un set di servizi di base .BSS.
Sintassi
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;
Members
dot11Ssid
SSID del punto di accesso (AP) o della stazione peer associata a BSS. Il tipo di dati per questo membro è una struttura DOT11_SSID .
uPhyId
Identificatore (ID) dell'interfaccia PHY usata per rilevare la rete BSS.
dot11Bssid
Indirizzo MAC (Media Access Control) del punto di accesso per le reti BSS dell'infrastruttura o della peer station per reti BSS indipendenti (reti ad hoc) che hanno inviato il frame 802.11 Beacon o Probe Response ricevuto dall'interfaccia LAN wireless durante l'analisi. Il tipo di dati per questo membro è una struttura DOT11_MAC_ADDRESS .
dot11BssType
Tipo di rete BSS. Il tipo di dati per questo membro è un valore di enumerazione DOT11_BSS_TYPE .
Questo membro può essere uno dei valori seguenti.
| Valore | Significato |
|---|---|
|
Specifica una rete BSS dell'infrastruttura. |
|
Specifica una rete BSS (IBSS) indipendente (una rete ad hoc). |
dot11BssPhyType
Tipo PHY per questa rete. Il tipo di dati per questo membro è un valore di enumerazione DOT11_PHY_TYPE .
lRssi
Valore DELL'indicatore di forza del segnale ricevuto (RSSI), in unità di decibel a cui si fa riferimento a 1,0 milliwatts (dBm), come rilevato dal driver di interfaccia LAN wireless per l'API o la stazione peer.
uLinkQuality
Qualità del collegamento segnalata dal driver di interfaccia LAN wireless. Il valore di qualità del collegamento varia da 0 a 100. Un valore pari a 100 specifica la qualità di collegamento più alta.
bInRegDomain
Valore che specifica se l'API o la stazione peer operano all'interno del dominio normativo come identificato dal paese/area geografica.
Se il driver dell'interfaccia LAN wireless non supporta più domini normativi, questo membro è impostato su TRUE.
Se il frame 802.11 Beacon o Probe Response ricevuto dall'AP o dalla peer station non include un elemento Informazioni paese (IE), questo membro è impostato su TRUE.
Se il frame 802.11 Beacon o Probe Response ricevuto dall'API o dalla peer station include un'operatore di Internet Explorer del paese, questo membro viene impostato su FALSE se il valore del sottocampo Country String non è uguale alla stringa del paese di input.
usBeaconPeriod
Valore del campo Intervallo di beacon dal frame Di risposta di beacon o probe 802.11 ricevuto dall'interfaccia LAN wireless.
L'intervallo è compreso tra 1.024 unità di tempo di microsecondo tra i tempi di trasmissione del beacon di destinazione. Queste informazioni vengono recuperate dal pacchetto di beacon inviato da un punto di accesso in una rete BSS dell'infrastruttura o da una risposta probe da un punto di accesso o da una stazione peer in risposta a un client LAN wireless che invia una richiesta probe.
Lo standard IEEE 802.11 definisce un'unità di tempo uguale a 1.024 microsecondi. Questa unità è stata definita in modo che possa essere facilmente implementata nell'hardware.
ullTimestamp
Il valore del campo Timestamp dal frame Beacon o Probe Response 802.11 ricevuto dall'interfaccia LAN wireless.
ullHostTimestamp
Valore timestamp host che registra quando l'interfaccia LAN wireless ha ricevuto il frame Di risposta di Beacon o Probe. Questo membro è un conteggio di 100-nanosecondi intervalli dal 1° gennaio 1601.
Per altre informazioni, vedere la funzione NdisGetCurrentSystemTime documentata in WDK.
usCapabilityInformation
Valore del campo Informazioni sulle funzionalità dal frame Di risposta del beacon o probe 802.11 ricevuto dall'interfaccia LAN wireless. Questo valore è un set di flag di bit che definiscono la funzionalità.
Questo membro può essere uno o più dei valori seguenti.
ulChCenterFrequency
Frequenza del centro del canale della banda in cui è stato ricevuto il frame Di risposta del beacon o probe 802.11. Il valore di ulChCenterFrequency è in unità di kilohertz (kHz).
wlanRateSet
Set di velocità di trasferimento dei dati supportate dal servizio BSS. Il tipo di dati per questo membro è una struttura WLAN_RATE_SET .
ulIeOffset
Offset, in byte, del BLOB di dati dell'elemento information (IE) dall'inizio della struttura WLAN_BSS_ENTRY .
Questo membro punta a un buffer che contiene elementi di informazioni a lunghezza variabile (IES) dai frame Di risposta 802.11 Beacon o Probe. Per ogni BSS, gli IES provengono dall'ultimo frame Di risposta di beacon o probe ricevuti dalla rete BSS. Se un IE è disponibile in un solo frame, il driver dell'interfaccia LAN wireless unisce l'IE con gli altri IE dall'ultimo frame di risposta di Beacon o Probe ricevuti.
Gli elementi informativi sono definiti nelle specifiche IEEE 802.11 per avere un formato generale comune costituito da un campo ID elemento a 1 byte, un campo Lunghezza a 1 byte e un campo informativo specifico dell'elemento a lunghezza variabile. Ogni elemento informativo viene assegnato un valore id elemento univoco come definito in questo standard IEEE 802.11. Il campo Lunghezza specifica il numero di byte nel campo informazioni.
ulIeSize
Dimensioni, in byte, del BLOB di dati di Internet Explorer nella struttura WLAN_BSS_ENTRY .
Si tratta della lunghezza esatta dei dati nel buffer a cui punta il membro ulIeOffset e non contiene alcuna spaziatura interna per l'allineamento. Il valore massimo per le dimensioni del BLOB di dati di Internet Explorer è di 2.324 byte.
Commenti
La funzione WlanGetNetworkBssList recupera l'elenco BSS della rete wireless o delle reti in un'interfaccia specifica e restituisce queste informazioni in una struttura WLAN_BSS_LIST che contiene una matrice di . WLAN_BSS_ENTRY strutture.
Quando l'interfaccia LAN wireless funziona anche come rete ospitata wireless, l'elenco BSS conterrà una voce per il servizio BSS creato per la rete ospitata wireless.
Poiché le informazioni vengono restituite dal punto di accesso per una rete BSS dell'infrastruttura o dal peer di rete per una rete BSS indipendente (rete ad hoc), le informazioni restituite non devono essere attendibili. I membri ulIeOffset e ulIeSize nella struttura WLAN_BSS_ENTRY devono essere usati per determinare la dimensione massima del BLOB dati dell'elemento informativo nella struttura WLAN_BSS_ENTRY , non i dati nel BLOB dati dell'elemento informativo.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista [solo app desktop] |
| Server minimo supportato | Windows Server 2008 [solo app desktop] |
| Intestazione | wlanapi.h |
Vedi anche
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per