struttura DOT11_BSS_ENTRY (windot11.h)
Sintassi
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;
Members
uPhyId
Identificatore (ID) della PHY usata dalla stazione 802.11 per rilevare la rete BSS. L'ID PHY è l'indice all'interno dell'elenco dei PHY supportati restituiti dal driver tramite una query di OID_DOT11_SUPPORTED_PHY_TYPES.
Questo ID non deve essere DOT11_PHY_ID_ANY.
PhySpecificInfo
Attributi del PHY a cui fa riferimento il membro uPhyId . PhySpecificInfo è formattato come DOT11_BSS_ENTRY_PHY_SPECIFIC_INFO'unione .
dot11BSSID
Indirizzo MAC (Media Access Control) del punto di accesso (AP) (per le reti BSS dell'infrastruttura) o della stazione peer (per reti BSS indipendenti) che hanno inviato il frame 802.11 Beacon o Probe Response ricevuto dalla stazione 802.11 durante l'analisi. Il tipo di dati per questo membro è la struttura DOT11_MAC_ADDRESS .
dot11BSSType
Tipo di rete BSS.
Il tipo di dati per questo membro è l'enumerazione DOT11_BSS_TYPE . Il driver miniport non deve impostare questo membro sul valore dot11_BSS_type_any .
lRSSI
Valore rssI (Signal Strength Indicator) ricevuto, in unità di decibel a cui si fa riferimento a 1,0 milliwatt (dBm), come rilevato dalla stazione 802.11 per la stazione AP o peer.
uLinkQuality
Valore di qualità del collegamento compreso tra 0 e 100. Il valore 100 specifica la qualità del collegamento più elevata. Per altre informazioni sulla determinazione della qualità dei collegamenti, vedere Link Quality Operations.
bInRegDomain
Questo membro specifica se la stazione AP o peer opera all'interno del dominio normativo come identificato dalla stringa del paese di input. Per impostare questo membro, il driver miniport deve usare le linee guida seguenti:
- Se la stazione 802.11 non supporta più domini normativi, impostare il membro su TRUE. Per altre informazioni su più domini normativi, vedere OID_DOT11_MULTI_DOMAIN_CAPABILITY_IMPLEMENTED.
- Se la stringa del paese di input è tutti zeri, impostare il membro su TRUE.
- Se l'AP o la stazione peer non funziona su un canale valido per il dominio normativo specificato dalla stringa del paese di input, impostare il membro su FALSE.
-
Se il frame 802.11 Beacon o Probe Response, ricevuto dalla stazione AP o peer, non include un elemento Informazioni paese (IE), impostare il membro su TRUE.
Per altre informazioni su Country IE, vedere la clausola 7.3.2.12 dello standard IEEE 802.11d-2001.
- Se il frame di risposta 802.11 Beacon o Probe, ricevuto dalla stazione AP o peer, include un Oggetto IE country, impostare il membro su FALSE se il valore del sottocampo Country String non è uguale alla stringa del paese di input.
- Impostare il membro su TRUE in tutti gli altri casi.
usBeaconPeriod
Valore del campo Intervallo beacon dal frame 802.11 Beacon o Probe Response.
ullTimestamp
Valore del campo Timestamp del frame 802.11 Beacon o Probe Response.
ullHostTimestamp
Il timestamp, risolto tramite una chiamata a NdisGetCurrentSystemTime, che registra quando la stazione 802.11 ha ricevuto il frame 802.11 Beacon o Probe Response.
usCapabilityInformation
Valore del campo Capability Information (Informazioni sulle funzionalità) del frame 802.11 Beacon o Probe Response (Risposta probe).
uBufferLength
Lunghezza, in byte, della matrice ucBuffer nella struttura DOT11_BSS_ENTRY. ulBufferLength deve essere la lunghezza esatta dei dati nella matrice ucBuffer e non deve contenere spaziatura interna per l'allineamento.
ucBuffer[1]
Elementi informativi a lunghezza variabile (IEs) dei frame di risposta 802.11. Per ogni BSS, gli IEs devono provenire dall'ultimo frame di risposta beacon o probe ricevuto dalla rete BSS. Se un IE è disponibile in un solo fotogramma, il driver miniport deve unire l'IE con gli altri IE dall'ultimo frame di risposta beacon o probe ricevuto.
Quando la scheda di interfaccia di rete è in modalità op estendibile (ExtAP), l'elenco BSS deve contenere una voce per il BSS creato dalla scheda di interfaccia di rete.
Per altre informazioni sui campi all'interno di frame IEEE 802.11 Beacon o Probe Response, vedere la clausola 8.4 dello standard IEEE 802.11-2012.
Commenti
Quando la stazione 802.11 esegue un'operazione di analisi, il driver miniport nativo 802.11 memorizza nella cache i fotogrammi 802.11 Beacon e Probe Response ricevuti. Per altre informazioni sull'operazione di analisi, vedere Operazioni di analisi native 802.11.
Dopo che la stazione 802.11 completa l'operazione di analisi, il driver miniport restituisce l'elenco dei frame di risposta beacon e probe memorizzati nella cache quando viene eseguita una query da OID_DOT11_ENUM_BSS_LIST. Una struttura di DOT11_BSS_ENTRY separata viene formattata per ogni frame Beacon e Probe Response.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows. |
| Intestazione | windot11.h (include Ndis.h) |