structure DOT11_SCAN_REQUEST_V2 (windot11.h)

Article
08/08/2023

Important L’interface LAN sans fil Native 802.11 est déconseillée dans Windows 10 et versions ultérieures. Utilisez l’interface WDI (Wlan Device Driver Interface) à la place. Pour plus d’informations sur WDI, consultez Modèle de pilote Windows universel WLAN.

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.

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é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 :

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 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.

dot11_scan_type_passive

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.

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 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.

Note Le bit dot11_scan_type_forced n’est pris en charge que lorsque le pilote miniport fonctionne en mode Extensible Station (ExtSTA). Le bit dot11_scan_type_forced doit être défini par le biais d’un ou au niveau du bit avec une valeur DOT11_SCAN_TYPE.

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.

Remarques

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.

Configuration requise

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)

Voir aussi

DOT11_PHY_TYPE_INFO

OID_DOT11_SCAN_REQUEST

Partager via