DOT11_SCAN_REQUEST_V2 struttura (windot11.h)
La struttura DOT11_SCAN_REQUEST_V2 definisce i parametri per l'operazione di analisi esplicita eseguita dalla stazione 802.11. La stazione esegue l'operazione di analisi esplicita seguendo una richiesta di set OID di OID_DOT11_SCAN_REQUEST.
Sintassi
typedef struct _DOT11_SCAN_REQUEST_V2 {
DOT11_BSS_TYPE dot11BSSType;
DOT11_MAC_ADDRESS dot11BSSID;
DOT11_SCAN_TYPE dot11ScanType;
BOOLEAN bRestrictedScan;
ULONG udot11SSIDsOffset;
ULONG uNumOfdot11SSIDs;
BOOLEAN bUseRequestIE;
ULONG uRequestIDsOffset;
ULONG uNumOfRequestIDs;
ULONG uPhyTypeInfosOffset;
ULONG uNumOfPhyTypeInfos;
ULONG uIEsOffset;
ULONG uIEsLength;
UCHAR ucBuffer[1];
} DOT11_SCAN_REQUEST_V2, *PDOT11_SCAN_REQUEST_V2;
Members
dot11BSSType
Tipo di reti BSS (Basic Service Set) per cui la stazione 802.11 analizza. Il tipo di dati per questo membro è l'enumerazione DOT11_BSS_TYPE .
dot11BSSID
Identificatore BSS (BSSID) di una rete BSS per cui la stazione 802.11 analizza. Se questo membro è impostato sul carattere jolly BSSID (0xFFFFFFFFFFFF), la stazione esegue l'analisi di tutti i BSSID.
dot11ScanType
Tipo di analisi eseguita dalla stazione 802.11. Il tipo di dati per questo membro è l'enumerazione DOT11_SCAN_TYPE, che dichiara i valori seguenti:
dot11_scan_type_active
La stazione trasmette un frame di richiesta probe 802.11 su ogni canale a cui esegue l'analisi. Si trova sul canale abbastanza lungo per ricevere 802.11 frame di risposta probe per la relativa richiesta probe. La stazione riceve anche 802.11 frame beacon inviati sul canale.
dot11_scan_type_passive
La stazione non trasmette un frame di richiesta probe 802.11 su ogni canale a cui esegue l'analisi. Riceve invece 802.11 Beacon o Probe Request frame inviati sul canale.
dot11_scan_type_auto
La stazione può eseguire analisi attive o passive oppure può usare una combinazione di entrambi i tipi di analisi.
Indipendentemente dal valore dot11ScanType, la stazione 802.11 deve eseguire un tipo di analisi di dot11_scan_type_passive ogni volta che analizza i canali non validi nel dominio normativo corrente. Inoltre, la stazione 802.11 deve eseguire un tipo di analisi di dot11_scan_type_passive se non dispone di un dominio normativo predefinito. Per altre informazioni sui domini normativi, vedere OID_DOT11_CURRENT_REG_DOMAIN.
Se il bit di dot11_scan_type_forced è impostato nel membro dot11ScanType , la stazione 802.11 deve eseguire un'analisi completa su ogni canale supportato. Se il bit di dot11_scan_type_forced non è impostato, la stazione 802.11 può eseguire un'analisi completa oppure eseguire un'analisi parziale su un subset dei canali supportati.
bRestrictedScan
Se questo membro è TRUE, la stazione 802.11 esegue un'analisi limitata alla configurazione canale e PHY PHY usata per connettersi a una rete BSS.
Il driver miniport deve ignorare questo membro se uno dei seguenti è true:
- Il driver miniport è operativo in modalità ExtSTA.
- La stazione 802.11 non è connessa a una rete BSS.
udot11SSIDsOffset
Offset nella matrice ucBuffer in cui inizia l'elenco SSID (Service Set Identifier). Ogni voce nell'elenco SSID viene formattata come struttura DOT11_SSID .
La stazione 802.11 analizza ogni SSID nell'elenco. Ad esempio, se dot11ScanType è impostato su dot11_scan_type_active, la stazione 802.11 trasmette una richiesta probe 802.11 per ogni SSID nell'elenco durante l'analisi su un canale.
uNumOfdot11SSIDs
Numero di voci nell'elenco SSID.
Se uNumOfdot11SSID è zero, il driver miniport deve usare un elenco SSID contenente il carattere jolly SSID.
bUseRequestIE
Se questo membro è TRUE, la stazione 802.11 deve includere l'elenco di ID richiesta (definiti tramite i membri uRequestIDsOffset e uNumOfRequestIDs ) all'interno dell'elemento 802.11d request information (IE) di ogni frame di richiesta probe che trasmette durante l'analisi attiva.
Il driver miniport deve ignorare questo membro (insieme ai membri uRequestIDsOffset e uNumOfRequestIDs ) se uno dei seguenti è true:
- Il driver miniport è operativo in modalità ExtSTA.
- L'oggetto 802.11 dot11MultiDomainCapabilityEnabled Management Base (MIB) è FALSE. Per altre informazioni sull'oggetto DOT11MultiDomainCapabilityEnabled MIB, vedere OID_DOT11_MULTI_DOMAIN_CAPABILITY_ENABLED.
- Il membro dot11ScanType è impostato su dot11_scan_type_passive.
uRequestIDsOffset
Offset nella matrice ucBuffer in cui inizia l'elenco ID richiesta. Ogni voce nell'elenco ID richiesta viene formattata come tipo di dati UCHAR.
uNumOfRequestIDs
Numero di voci nell'elenco ID richiesta.
uPhyTypeInfosOffset
Offset nella matrice ucBuffer in cui inizia l'elenco di tipi PHY. Ogni voce nell'elenco dei tipi PHY viene formattata come struttura DOT11_PHY_TYPE_INFO .
La stazione 802.11 deve eseguire l'analisi BSS usando ognuno dei tipi PHY specificati da questo elenco.
Il driver miniport deve ignorare questo membro (insieme al membro uNumOfPhyTypeInfos ) se bRestrictedScan è impostato su TRUE.
uNumOfPhyTypeInfos
Numero di voci nell'elenco dei tipi PHY.
Se uNumOfPhyTypeInfos è zero, la stazione 802.11 esegue l'analisi usando tutti i relativi PHY supportati.
uIEsOffset
Offset nella matrice ucBuffer in cui inizia l'elenco di elementi informativi a lunghezza variabile (IES). La stazione 802.11 deve aggiungere l'elenco di IES alla fine di ogni frame di richiesta probe che trasmette durante un'analisi attiva.
Il driver miniport deve ignorare questo membro (insieme al membro uIEsLength ) se dot11ScanType è impostato su dot11_scan_type_passive.
uIEsLength
Lunghezza, in byte, dell'elenco di IES.
ucBuffer[1]
Buffer contenente dati facoltativi come specificato tramite altri membri di questa struttura.
Commenti
La stazione 802.11 esegue operazioni di analisi esplicite seguendo la richiesta del set OID di OID_DOT11_SCAN_REQUEST. La stazione esegue l'operazione di analisi usando i parametri definiti tramite la DOT11_SCAN_REQUEST_V2, che accompagna la richiesta impostata.
Per altre informazioni sulle operazioni di analisi eseguite da un driver miniport nativo 802.11, vedere Operazioni di analisi native 802.11.
Per altre informazioni sulla modalità di operazione ExtSTA, vedere Modalità operazione Estendibile Stazione.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows. |
| Intestazione | windot11.h (include Ndis.h) |