structure DOT11_PHY_TYPE_INFO (windot11.h)

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

La structure DOT11_PHY_TYPE_INFO définit les paramètres que la station 802.11 utilise pour configurer un PHY lors d’une opération d’analyse explicite. La station effectue l’opération d’analyse explicite à la suite d’une demande d’ensemble de OID_DOT11_SCAN_REQUEST.

Syntaxe

typedef struct _DOT11_PHY_TYPE_INFO {
  union {
    DOT11_PHY_TYPE dot11PhyType;
    ULONG          uPhyId;
  };
  BOOLEAN             bUseParameters;
  ULONG               uProbeDelay;
  ULONG               uMinChannelTime;
  ULONG               uMaxChannelTime;
  CH_DESCRIPTION_TYPE ChDescriptionType;
  ULONG               uChannelListSize;
  UCHAR               ucChannelListBuffer[1];
} DOT11_PHY_TYPE_INFO, *PDOT11_PHY_TYPE_INFO;

Membres

dot11PhyType

Type de PHY que la station 802.11 utilisera pour l’analyse. Le type PHY est défini par l’énumération DOT11_PHY_TYPE .

Note Le pilote miniport doit ignorer ce membre s’il fonctionne en mode ExtSTA (Extensible Station).

bUseParameters

Si ce membre a la valeur TRUE, la station 802.11 utilise les autres membres de cette structure pour configurer le PHY pour l’opération d’analyse.

Si ce membre a la valeur FALSE, la station 802.11 configure le PHY à l’aide de ses propres paramètres pour l’opération d’analyse.

Note Si le pilote miniport fonctionne en mode ExtSTA, le système d’exploitation définit toujours ce membre sur FALSE.

uProbeDelay

Durée, en microsecondes, pendant laquelle la station 802.11 doit attendre avant de transmettre une image de requête de sonde 802.11 pendant l’analyse active.

uMinChannelTime

Durée minimale, en unités de temps (TU) de 802,11, que la station 802.11 passe sur chaque canal lors de l’analyse. Une TU est de 1 024 microsecondes.

Ce membre doit être supérieur ou égal à uProbeDelay .

uMaxChannelTime

Durée maximale, dans 802.11 unités de temps (TU), que la station 802.11 passe sur chaque canal lors de l’analyse.

Ce membre doit être supérieur ou égal à uProbeDelay .

ChDescriptionType

Ce membre spécifie la méthode utilisée pour interpréter les entrées dans le tableau ucChannelListBuffer . Le type de données de ce membre est l’énumération CH_DESCRIPTION_TYPE, qui déclare les valeurs suivantes :

ch_description_type_logical

L’entrée de canal est définie par un numéro de canal logique pour être conforme à la norme IEEE 802.11.

ch_description_type_center_frequency

L’entrée de canal est définie, en unités de mégahertz (MHz), par une fréquence centrale de canal.

uChannelListSize

Longueur, en octets, du tableau ucChannelListBuffer . Chaque entrée de ce tableau est mise en forme en tant que type de données ULONG.

ucChannelListBuffer[1]

Tableau contenant des descriptions de canal pour le type PHY spécifié dans le membre dot11PhyType .

Remarques

La structure DOT11_SCAN_REQUEST_V2 , qui accompagne une demande d’ensemble de OID_DOT11_SCAN_REQUEST, contient un tableau de zéro ou plus DOT11_PHY_TYPE_INFO entrées.

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 de fonctionnement ExtSTA, consultez Mode d’opération de station extensible.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans Windows Vista et les versions ultérieures des systèmes d’exploitation Windows.
En-tête	windot11.h (inclure Ndis.h)

Voir aussi

DOT11_SCAN_REQUEST_V2

OID_DOT11_SCAN_REQUEST