DOT11_STATISTICS structure (windot11.h)
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.
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.
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 :
- La fonction MiniportInitializeEx du pilote est appelée.
- La fonction MiniportOidRequest du pilote est appelée avec une demande de jeu d’OID de OID_DOT11_RESET_REQUEST, quel que soit le type d’opération de réinitialisation spécifié dans la demande d’ensemble.
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) |