struttura DOT11_BSS_ENTRY (windot11.h)

Articolo
02/27/2024

Importante L'interfaccia LAN wireless native 802.11 è deprecata in Windows 10 e versioni successive. Usare invece l'interfaccia WDI (WLAN Device Driver Interface). Per altre informazioni su WDI, vedere Modello di driver WINDOWS universale WLAN.

La struttura DOT11_BSS_ENTRY definisce un beacon o un frame di risposta IEEE 802.11 ricevuto dalla stazione 802.11 durante l'ultima operazione di analisi.

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)