DOT11_STATISTICS structure (windot11.h)

  • Article
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_STATISTICS enregistre les compteurs statistiques pour l’interface 802.11.

Syntaxe

typedef struct DOT11_STATISTICS {
  NDIS_OBJECT_HEADER         Header;
  ULONGLONG                  ullFourWayHandshakeFailures;
  ULONGLONG                  ullTKIPCounterMeasuresInvoked;
  ULONGLONG                  ullReserved;
  DOT11_MAC_FRAME_STATISTICS MacUcastCounters;
  DOT11_MAC_FRAME_STATISTICS MacMcastCounters;
  DOT11_PHY_FRAME_STATISTICS PhyCounters[1];
} DOT11_STATISTICS, *PDOT11_STATISTICS;

Membres

Header

Type, révision et taille de la structure DOT11_STATISTICS. Ce membre est mis en forme en tant que structure NDIS_OBJECT_HEADER .

Le pilote miniport doit définir les membres de Header sur les valeurs suivantes :

Type

Ce membre doit être défini sur NDIS_OBJECT_TYPE_DEFAULT.

Révision

Ce membre doit être défini sur DOT11_STATISTICS_REVISION_1.

Taille

Ce membre doit être défini sur sizeof(DOT11_STATISTICS).

Pour plus d’informations sur ces membres, consultez NDIS_OBJECT_HEADER.

ullFourWayHandshakeFailures

Nombre d’échecs de négociation à quatre voies rencontrés par la station 802.11 pendant Wi-Fi'authentification WPA (Accès protégé) ou RSNA (Robust Security Network Association).

Si la station 802.11 n’effectue pas l’authentification WPA ou RSNA, elle doit définir ce membre sur DOT11_STATISTICS_UNKNOWN.

ullTKIPCounterMeasuresInvoked

Nombre de fois où la station 802.11 a appelé des contre-mesures à la suite d’une défaillance du code d’intégrité des messages (MIC).

Si la station 802.11 n’effectue pas de contre-mesures TKIP, elle doit définir ce membre sur DOT11_STATISTICS_UNKNOWN.

ullReserved

Ce membre est réservé au système d’exploitation. Le pilote miniport ne doit pas écrire à ce membre.

MacUcastCounters

Compteurs de couche MAC basés sur les paquets en monodiffusion envoyés ou reçus par la station 802.11. La structure de données de ce membre est la DOT11_MAC_FRAME_STATISTICS structure.

Remarque  

Les compteurs des paquets de monodiffusion reçus doivent être incrémentés uniquement pour les paquets avec une adresse MAC de destination dans l’en-tête MAC 802.11 qui correspond à l’adresse MAC de la station 802.11.

MacMcastCounters

Compteurs de couche MAC basés sur des paquets de multidiffusion ou de diffusion envoyés ou reçus par la station 802.11. La structure de données de ce membre est la DOT11_MAC_FRAME_STATISTICS structure.

Remarque  

Les compteurs des paquets de multidiffusion ou de diffusion reçus doivent uniquement être incrémentés pour les paquets dont l’adresse MAC de destination se trouve dans l’en-tête MAC 802.11 qui correspond à une entrée dans la liste d’adresses de multidiffusion de la station 802.11. Pour plus d’informations sur la liste d’adresses de multidiffusion, consultez OID_DOT11_MULTICAST_LIST.

PhyCounters[1]

Tableau de compteurs de couche PHY. Chaque entrée de ce tableau est au format DOT11_PHY_FRAME_STATISTICS structure.

Le pilote miniport doit conserver une entrée dans le tableau PhyCounters pour chaque PHY pris en charge. Si la station 802.11 prend en charge plusieurs PHYs du même type, le pilote miniport doit créer des entrées distinctes pour chacune d’elles.

Les entrées dans le tableau PhyCounters doivent être dans le même ordre que la liste des phYs pris en charge que le pilote retourne lorsqu’ils sont interrogés par OID_DOT11_SUPPORTED_PHY_TYPES.

Remarques

Le pilote miniport doit définir de manière inconditionnelle tous les compteurs de la structure DOT11_STATISTICS sur zéro, y compris les compteurs de couche MAC et de couche PHY, lorsque l’une des opérations suivantes se produit :

Pour plus d’informations sur les statistiques collectées par un pilote de miniport natif 802.11, consultez Statistiques natives 802.11.

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

OID_DOT11_STATISTICS