structure DOT11_MAC_FRAME_STATISTICS (windot11.h)

2025-02-07

Important

WiFiCx est le nouveau modèle de pilote Wi-Fi publié dans Windows 11. Nous vous recommandons d’utiliser WiFiCx pour tirer parti des dernières fonctionnalités. Le modèle de pilote WDI est désormais en mode maintenance et ne reçoit que des correctifs de priorité élevée.

La structure DOT11_MAC_FRAME_STATISTICS enregistre les compteurs statistiques pour le sous-couche MAC (Media Access Control) IEEE de la station 802.11.

Syntaxe

typedef struct DOT11_MAC_FRAME_STATISTICS {
  ULONGLONG ullTransmittedFrameCount;
  ULONGLONG ullReceivedFrameCount;
  ULONGLONG ullTransmittedFailureFrameCount;
  ULONGLONG ullReceivedFailureFrameCount;
  ULONGLONG ullWEPExcludedCount;
  ULONGLONG ullTKIPLocalMICFailures;
  ULONGLONG ullTKIPReplays;
  ULONGLONG ullTKIPICVErrorCount;
  ULONGLONG ullCCMPReplays;
  ULONGLONG ullCCMPDecryptErrors;
  ULONGLONG ullWEPUndecryptableCount;
  ULONGLONG ullWEPICVErrorCount;
  ULONGLONG ullDecryptSuccessCount;
  ULONGLONG ullDecryptFailureCount;
} DOT11_MAC_FRAME_STATISTICS, *PDOT11_MAC_FRAME_STATISTICS;

Membres

ullTransmittedFrameCount

Nombre de paquets MSDU (Mac Service Data Unit) et d’images MMPDU (Mac Management Protocol Data Unit) transmises par la sous-couche MAC IEEE de la station 802.11.

ullReceivedFrameCount

Nombre de paquets MSDU et de trames MMPDU que la sous-couche MAC IEEE de la station 802.11 a correctement reçue. Ce membre ne doit pas être incrémenté pour les paquets reçus qui ont échoué au déchiffrement de chiffrement ou à la validation MIC.

ullTransmittedFailureFrameCount

Le nombre de paquets MSDU et de trames MMPDU que la sous-couche MAC IEEE de la station 802.11 n’a pas pu transmettre correctement.

ullReceivedFailureFrameCount

Le nombre de paquets MSDU et de trames MMPDU que la sous-couche MAC IEEE de la station 802.11 n’a pas pu recevoir avec succès.

ullWEPExcludedCount

Nombre d’images MPDU (Non chiffrées) reçues par l’unité de données de protocole MAC ignorées par le sous-calque MAC lorsque l’objet IEEE 802.11 dot11ExcludeUnencrypted base d’informations de gestion (MIB) est activé. Pour plus d’informations sur cet objet MIB, consultez OID_DOT11_EXCLUDE_UNENCRYPTED.

Les images MPDU sont considérées comme non chiffrées lorsque le sous-champ Frame protégé du champ Contrôle d’images dans l’en-tête MAC IEEE 802.11 est défini sur zéro.

ullTKIPLocalMICFailures

Nombre de paquets MSDU reçus que la station 802.11 a ignoré en raison d’échecs MIC.

ullTKIPReplays

Nombre de trames MPDU reçues que la station 802.11 a ignorée en raison de la procédure de protection contre la relecture TKIP.

ullTKIPICVErrorCount

Nombre de trames MPDU chiffrées que la station 802.11 n’a pas pu déchiffrer en raison d’une erreur ICV TKIP.

ullCCMPReplays

Nombre de trames MPDU reçues ignorées par la station 802.11 en raison de la procédure de protection contre la relecture AES-CCMP.

ullCCMPDecryptErrors

Nombre d’images MPDU reçues ignorées par la station 802.11 en raison d’erreurs détectées par l’algorithme de déchiffrement AES-CCMP.

ullWEPUndecryptableCount

Nombre de trames MPDU chiffrées reçues pour lesquelles une clé de déchiffrement WEP n’était pas disponible sur la station 802.11.

ullWEPICVErrorCount

Nombre de trames MPDU chiffrées que la station 802.11 n’a pas pu déchiffrer en raison d’une erreur ICV WEP.

ullDecryptSuccessCount

Nombre de paquets chiffrés reçus que la station 802.11 a correctement déchiffrée.

Pour les algorithmes de chiffrement WEP et TKIP, le pilote miniport doit incrémenter ce compteur pour chaque MPDU chiffré reçu qui a été correctement déchiffré. Pour l’algorithme de chiffrement AES-CCMP, le pilote miniport doit incrémenter ce compteur sur chaque paquet MSDU chiffré reçu qui a été correctement déchiffré.

ullDecryptFailureCount

Nombre de paquets chiffrés que la station 802.11 n’a pas pu déchiffrer.

Pour les algorithmes de chiffrement WEP et TKIP, le pilote miniport doit incrémenter ce compteur pour chaque MPDU chiffré reçu qui n’a pas été correctement déchiffré. Pour l’algorithme de chiffrement AES-CCMP, le pilote miniport doit incrémenter ce compteur sur chaque paquet MSDU chiffré reçu qui n’a pas été correctement déchiffré.

Le pilote miniport ne doit pas incrémenter ce compteur pour les paquets qui sont déchiffrés avec succès, mais sont ignorés pour d’autres raisons. Par exemple, le pilote miniport ne doit pas incrémenter ce compteur pour les paquets ignorés en raison d’échecs de MICRO TKIP ou de relecture TKIP/CCMP.

Remarques

Les membres de la structure DOT11_MAC_STATISTICS sont utilisés pour enregistrer les statistiques au niveau MAC pour :

802.11 Paquets MSDU.
Images MMPDU 802.11.
Images MPDU 802.11. Les compteurs d’images MPDU doivent inclure tous les fragments MPDU envoyés pour un paquet MSDU ou une trame MMPDU

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)

Voir aussi

OID_DOT11_STATISTICS

statistiques MAC de station extensible

DOT11_STATISTICS

statistiques natives 802.11

Partager via