DOT11_BSS_ENTRY struttura (windot11.h)

Importante L'interfaccia LAN wireless nativa 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 peer station (per le reti BSS indipendenti) che ha inviato il frame Di risposta di 802.11 beacon o probe 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 milliwatts (dBm), come rilevato dalla stazione 802.11 per la stazione AP o peer.

uLinkQuality

Valore di qualità del collegamento compreso tra 0 e 100. Un valore pari a 100 specifica la qualità di collegamento più alta. Per altre informazioni sulla determinazione della qualità dei collegamenti, vedere Link Quality Operations.

bInRegDomain

Questo membro specifica se l'API o la stazione peer operano 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 zero, impostare il membro su TRUE.
  • Se l'API 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 dall'API o dalla stazione 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 802.11 Beacon o Probe Response, ricevuto dalla stazione DI API o peer, include un oggetto Country IE, 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 di beacon dal frame Di risposta del beacon 802.11.

ullTimestamp

Valore del campo Timestamp dal frame 802.11 Beacon o Probe Response.

ullHostTimestamp

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 Informazioni sulle funzionalità dal frame Di risposta del beacon o probe 802.11.

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 alcun riempimento per l'allineamento.

ucBuffer[1]

Gli elementi di informazioni a lunghezza variabile (IES) dai frame di beacon o probe 802.11. Per ogni BSS, gli IES devono trovarsi dall'ultimo frame Di risposta di beacon o probe ricevuti 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 di beacon o probe ricevuti.

Quando la scheda di interfaccia di interfaccia di rete si trova nella 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 dei frame IEEE 802.11 Beacon o Probe Response, vedere 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 di risposta 802.11 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 di 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 Di risposta di beacon e probe.

Requisiti

   
Client minimo supportato Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows.
Intestazione windot11.h (include Ndis.h)

Vedi anche

DOT11_BSS_TYPE

DOT11_BSS_LIST

OID_DOT11_SUPPORTED_PHY_TYPES

OID_DOT11_MULTI_DOMAIN_CAPABILITY_IMPLEMENTED

DOT11_MAC_ADDRESS

DOT11_BSS_ENTRY_PHY_SPECIFIC_INFO

NdisGetCurrentSystemTime

OID_DOT11_ENUM_BSS_LIST