DOT11_BSS_ENTRY struttura (windot11.h)

Articolo
03/15/2022
4 minuti per la lettura

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

La DOT11_BSS_ENTRY definisce un faro 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) del PHY usato dalla stazione 802.11 per rilevare la rete BSS. L'ID PHY è l'indice all'interno dell'elenco di 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 le reti BSS indipendenti) che ha inviato il frame di risposta del beacon o del probe 802.11 ricevuto dalla stazione 802.11 durante l'analisi. Il tipo di dati per questo membro è la DOT11_MAC_ADDRESS struttura .

dot11BSSType

Tipo di rete BSS.

Il tipo di dati per questo membro è l'DOT11_BSS_TYPE di dati. Il driver miniport non deve impostare questo membro sul dot11_BSS_type_any valore.

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à di collegamento più elevata. Per altre informazioni sulla determinazione della qualità del collegamento, vedere Operazioni sulla qualità dei collegamenti.

bInRegDomain

Questo membro specifica se l'ap o la stazione peer opera all'interno del dominio normativo 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 dall'ap o dalla stazione peer, non include un elemento Informazioni sul paese (IE), impostare il membro su TRUE.
Per altre informazioni su Country IE, fare riferimento alla clausola 7.3.2.12 dello standard IEEE 802.11d-2001.
Se il frame 802.11 Beacon o Probe Response, ricevuto dall'ap o dalla stazione peer, include un 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 faro dal frame 802.11 Beacon o Probe Response.

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 di risposta del probe o del beacon 802.11.

usCapabilityInformation

Valore del campo Informazioni sulla funzionalità del frame di risposta del probe o del faro 802.11.

uBufferLength

Lunghezza, in byte, della matrice ucBuffer nella DOT11_BSS_ENTRY struttura . ulBufferLength deve essere la lunghezza esatta dei dati nella matrice ucBuffer e non deve contenere spaziatura interna per l'allineamento.

ucBuffer

Elementi di informazioni a lunghezza variabile (IE) dai frame 802.11 Beacon o Probe Response. Per ogni BSS, gli IE devono essere provenienti dall'ultimo frame di risposta di tipo beacon o probe ricevuto da tale rete BSS. Se un IE è disponibile in un solo frame, il driver miniport deve unire l'IE agli altri IE dell'ultimo frame di risposta del segnale o del probe ricevuto.

Quando la scheda di interfaccia di rete è in modalità OP Extensible Access Point (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 di risposta di tipo beacon o probe IEEE 802.11, 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 frame di risposta del probe e del beacon 802.11 ricevuti. Per altre informazioni sull'operazione di analisi, vedere Operazioni di analisi native 802.11.

Dopo che la stazione 802.11 ha completato l'operazione di analisi, il driver miniport restituisce l'elenco dei frame di risposta del beacon e del probe memorizzati nella cache quando viene eseguita una query OID_DOT11_ENUM_BSS_LIST. Una struttura DOT11_BSS_ENTRY è formattata per ogni frame di risposta del beacon e del probe.