structure DOT11_STATISTICS (windot11.h)
La structure DOT11_STATISTICS enregistre les compteurs statistiques de 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 l’en-tête 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 bidirectionnel rencontrés par la station 802.11 pendant Wi-Fi l’authentification WPA (Protected Access) ou Robust Security Network Association (RSNA).
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 suite à une défaillance du code d’intégrité du message (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é à une utilisation par le système d’exploitation. Le pilote miniport ne doit pas écrire dans ce membre.
MacUcastCounters
Compteurs de couche MAC basés sur des paquets de monodiffusion envoyés ou reçus par la station 802.11. La structure de données de ce membre est la structure DOT11_MAC_FRAME_STATISTICS.
Les compteurs pour les paquets monodiffusion reçus doivent uniquement être incrémentés pour ces 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 la multidiffusion ou les paquets de diffusion envoyés ou reçus par la station 802.11. La structure de données de ce membre est la structure DOT11_MAC_FRAME_STATISTICS.
Les compteurs pour les paquets de multidiffusion ou de diffusion reçus doivent uniquement être incrémentés pour ces paquets avec une adresse MAC de destination 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 mise en forme comme un structure DOT11_PHY_FRAME_STATISTICS.
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 chacun d’eux.
Les entrées dans le tableau PhyCounters doivent être dans le même ordre que la liste des PHY prises en charge que le pilote retourne lorsqu’il est interrogé par OID_DOT11_SUPPORTED_PHY_TYPES.
Remarques
Le pilote miniport doit définir inconditionnellement tous les compteurs de la structure DOT11_STATISTICS sur zéro, y compris les compteurs de couche MAC et DE COUCHE PHY, lorsque l’un des éléments suivants se produit :
- La fonction MiniportInitializeEx du pilote est appelée.
- La fonction MiniportOidRequest du pilote est appelée avec une requête de jeu d’OID de OID_DOT11_RESET_REQUEST, quel que soit le type d’opération de réinitialisation spécifié dans la requête définie.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible dans Windows Vista et versions ultérieures des systèmes d’exploitation Windows. |
| d’en-tête | windot11.h (include Ndis.h) |