structure DOT11_SCAN_REQUEST_V2 (windot11.h)
La structure DOT11_SCAN_REQUEST_V2 définit les paramètres de l’opération d’analyse explicite effectuée par la station 802.11. La station effectue l’opération d’analyse explicite après une demande de jeu d’OID de OID_DOT11_SCAN_REQUEST.
Syntaxe
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;
Membres
dot11BSSType
Type de réseau BSS (Basic Service Set) pour lequel la station 802.11 analyse. Le type de données de ce membre est l’énumération DOT11_BSS_TYPE.
dot11BSSID
Identificateur BSS (BSSID) d’un réseau BSS pour lequel la station 802.11 analyse. Si ce membre est défini sur le BSSID générique (0xFFFFFFFFFFFF), la station analyse tous les BSSID.
dot11ScanType
Type d’analyse effectué par la station 802.11. Le type de données de ce membre est l’énumération DOT11_SCAN_TYPE, qui déclare les valeurs suivantes :
dot11_scan_type_active
La station transmet une trame de requête de sonde 802.11 sur chaque canal qu’elle analyse. Il s’étend sur le canal suffisamment longtemps pour recevoir des trames de réponse de sonde 802.11 pour sa requête de sonde. La station reçoit également 802.11 trames beacon envoyées sur le canal.
dot11_scan_type_passive
La station ne transmet pas une trame de requête de sonde 802.11 sur chaque canal qu’elle analyse. Au lieu de cela, il reçoit 802.11 Trames de requête de balise ou de sonde envoyées sur le canal.
dot11_scan_type_auto
La station peut effectuer des analyses actives ou passives, ou utiliser une combinaison des deux types d’analyse.
Quelle que soit la valeur de dot11ScanType, la station 802.11 doit effectuer un type d’analyse de dot11_scan_type_passive chaque fois qu’elle analyse sur les canaux qui ne sont pas valides dans le domaine réglementaire actuel. En outre, la station 802.11 doit effectuer un type d’analyse de dot11_scan_type_passive s’il n’a pas de domaine réglementaire par défaut. Pour plus d’informations sur les domaines réglementaires, consultez OID_DOT11_CURRENT_REG_DOMAIN.
Si le bit dot11_scan_type_forced est défini dans le membre dot11ScanType, la station 802.11 doit effectuer une analyse complète sur chaque canal pris en charge. Si le bit dot11_scan_type_forced n’est pas défini, la station 802.11 peut effectuer une analyse complète ou effectuer une analyse partielle sur un sous-ensemble des canaux pris en charge.
bRestrictedScan
Si ce membre est TRUE, la station 802.11 effectue une analyse limitée au canal et à la configuration PHY utilisée pour se connecter à un réseau BSS.
Le pilote miniport doit ignorer ce membre si l’un des éléments suivants est vrai :
- Le pilote miniport fonctionne en mode ExtSTA.
- La station 802.11 n’est pas connectée à un réseau BSS.
udot11SSIDsOffset
Décalage dans le tableau ucBuffer où commence la liste d’identificateurs de jeu de services (SSID). Chaque entrée de la liste SSID est mise en forme sous forme de structure DOT11_SSID.
La station 802.11 analyse chaque SSID dans la liste. Par exemple, si dot11ScanType est défini sur dot11_scan_type_active, la station 802.11 transmet une demande de sonde 802.11 pour chaque SSID de la liste lors de l’analyse sur un canal.
uNumOfdot11SSIDs
Nombre d’entrées dans la liste SSID.
Si uNumOfdot11SSIDs est égal à zéro, le pilote miniport doit utiliser une liste SSID contenant le SSID de longueur zéro générique.
bUseRequestIE
Si ce membre est TRUE, la station 802.11 doit inclure la liste des ID de requête (définis par le biais de l'uRequestIDsOffset et uNumOfRequestIDs membres) dans l’élément d’informations de requête 802.11d (IE) de chaque frame de requête probe qu’il transmet pendant l’analyse active.
Le pilote miniport doit ignorer ce membre (ainsi que les uRequestIDsOffset et uNumOfRequestIDs membres) si l’un des éléments suivants est vrai :
- Le pilote miniport fonctionne en mode ExtSTA.
- L’objet 802.11 dot11MultiDomainCapabilityEnabled management information base (MIB) est FALSE. Pour plus d’informations sur l’objet dot11MultiDomainCapabilityEnabled MIB, consultez OID_DOT11_MULTI_DOMAIN_CAPABILITY_ENABLED.
- Le membre dot11ScanType est défini sur dot11_scan_type_passive.
uRequestIDsOffset
Décalage dans le tableau ucBuffer où commence la liste des ID de requête. Chaque entrée de la liste des ID de requête est mise en forme en tant que type de données UCHAR.
uNumOfRequestIDs
Nombre d’entrées dans la liste des ID de requête.
uPhyTypeInfosOffset
Décalage dans le tableau ucBuffer où commence la liste des types PHY. Chaque entrée de la liste des types PHY est mise en forme sous forme de structure DOT11_PHY_TYPE_INFO.
La station 802.11 doit effectuer l’analyse BSS à l’aide de chacun des types PHY spécifiés de cette liste.
Le pilote miniport doit ignorer ce membre (ainsi que le membre uNumOfPhyTypeInfos) si bRestrictedScan est défini sur TRUE.
uNumOfPhyTypeInfos
Nombre d’entrées dans la liste des types PHY.
Si uNumOfPhyTypeInfos est égal à zéro, la station 802.11 effectue l’analyse à l’aide de toutes ses PHY prises en charge.
uIEsOffset
Décalage dans le tableau ucBuffer où commence la liste des éléments d’informations de longueur variable (EE). La station 802.11 doit ajouter la liste des E/S à la fin de chaque trame de requête de sonde qu’elle transmet pendant une analyse active.
Le pilote miniport doit ignorer ce membre (ainsi que le membre uIEsLength) si dot11ScanType est défini sur dot11_scan_type_passive.
uIEsLength
Longueur, en octets, de la liste des E/S.
ucBuffer[1]
Mémoire tampon contenant des données facultatives spécifiées par le biais d’autres membres de cette structure.
Remarques
La station 802.11 effectue des opérations d’analyse explicites après la demande de jeu d’OID de OID_DOT11_SCAN_REQUEST. La station effectue l’opération d’analyse à l’aide des paramètres définis via le DOT11_SCAN_REQUEST_V2, qui accompagne la demande de jeu.
Pour plus d’informations sur les opérations d’analyse effectuées par un pilote miniport natif 802.11, consultez Opérations d’analyse natives 802.11.
Pour plus d’informations sur le mode d’opération ExtSTA, consultez mode d’opération de station extensible.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible dans Windows Vista et versions ultérieures des systèmes d’exploitation Windows. |
| d’en-tête | windot11.h (include Ndis.h) |