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 à la suite d’une demande de jeu d’OID de OID_DOT11_SCAN_REQUEST.
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;
dot11BSSType
Type de réseaux BSS (Basic Service Set) pour lesquels 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 :
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 les trames de réponse de la sonde 802.11 pour sa requête de sonde. La station reçoit également les trames 802.11 beacon envoyées sur le canal.
La station ne transmet pas de trame de requête de sonde 802.11 sur chaque canal qu’elle analyse. Au lieu de cela, il reçoit les trames 802.11 Beacon ou Probe Request envoyées sur le canal.
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 des 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 si elle 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 a la valeur 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’une des conditions suivantes est vraie :
- 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 en tant que structure DOT11_SSID .
La station 802.11 analyse chaque SSID de la liste. Par exemple, si dot11ScanType est défini sur dot11_scan_type_active, la station 802.11 transmet une requête 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 a la valeur TRUE, la station 802.11 doit inclure la liste des ID de requête (définis par le biais des membres uRequestIDsOffset et uNumOfRequestIDs ) dans l’élément 802.11d request information element (IE) de chaque frame probe Request qu’elle transmet pendant l’analyse active.
Le pilote miniport doit ignorer ce membre (ainsi que les membres uRequestIDsOffset et uNumOfRequestIDs ) si l’une des conditions suivantes est vraie :
- Le pilote miniport fonctionne en mode ExtSTA.
- L’objet MIB (Management Information Base) 802.11 dot11MultiDomainCapabilityEnabled est FALSE. Pour plus d’informations sur l’objet MIB dot11MultiDomainCapabilityEnabled , 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 demande 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 en tant que structure DOT11_PHY_TYPE_INFO .
La station 802.11 doit effectuer l’analyse BSS à l’aide de chacun des types PHY spécifiés dans cette liste.
Le pilote miniport doit ignorer ce membre (ainsi que le membre uNumOfPhyTypeInfos ) si bRestrictedScan a la valeur 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 tous ses PHYs pris en charge.
uIEsOffset
Décalage dans le tableau ucBuffer où commence la liste des éléments d’informations de longueur variable. La station 802.11 doit ajouter la liste des EI à la fin de chaque frame 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 les données facultatives spécifiées par le biais d’autres membres de cette structure.
La station 802.11 effectue des opérations d’analyse explicites à la suite de 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.
Condition requise | Valeur |
---|---|
Client minimal pris en charge | Disponible dans Windows Vista et versions ultérieures des systèmes d’exploitation Windows. |
En-tête | windot11.h (inclure Ndis.h) |