structure DOT11_PHY_FRAME_STATISTICS (windot11.h)
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_PHY_FRAME_STATISTICS enregistre les compteurs statistiques pour la couche physique IEEE (PHY) de la station 802.11.
Syntaxe
typedef struct DOT11_PHY_FRAME_STATISTICS {
ULONGLONG ullTransmittedFrameCount;
ULONGLONG ullMulticastTransmittedFrameCount;
ULONGLONG ullFailedCount;
ULONGLONG ullRetryCount;
ULONGLONG ullMultipleRetryCount;
ULONGLONG ullMaxTXLifetimeExceededCount;
ULONGLONG ullTransmittedFragmentCount;
ULONGLONG ullRTSSuccessCount;
ULONGLONG ullRTSFailureCount;
ULONGLONG ullACKFailureCount;
ULONGLONG ullReceivedFrameCount;
ULONGLONG ullMulticastReceivedFrameCount;
ULONGLONG ullPromiscuousReceivedFrameCount;
ULONGLONG ullMaxRXLifetimeExceededCount;
ULONGLONG ullFrameDuplicateCount;
ULONGLONG ullReceivedFragmentCount;
ULONGLONG ullPromiscuousReceivedFragmentCount;
ULONGLONG ullFCSErrorCount;
} DOT11_PHY_FRAME_STATISTICS, *PDOT11_PHY_FRAME_STATISTICS;
Membres
ullTransmittedFrameCount
Nombre de paquets MSDU et de trames MMPDU que la couche IEEE PHY de la station 802.11 a correctement transmis.
ullMulticastTransmittedFrameCount
Nombre de paquets MSDU de multidiffusion ou de diffusion et de trames MMPDU que la couche IEEE PHY de la station 802.11 a correctement transmis.
ullFailedCount
Nombre de paquets MSDU et de trames MMPDU que la station 802.11 n’a pas pu transmettre après avoir dépassé les limites de nouvelle tentative définies par les compteurs IEEE 802.11 IEEE dot11ShortRetryLimit ou dot11LongRetryLimit compteurs MIB. Pour plus d’informations sur ces compteurs MIB, consultez OID_DOT11_SHORT_RETRY_LIMIT ou OID_DOT11_LONG_RETRY_LIMIT.
ullRetryCount
Nombre de paquets MSDU et de trames MMPDU que la station 802.11 a correctement transmises après une ou plusieurs tentatives.
ullMultipleRetryCount
Nombre de paquets MSDU et de trames MMPDU que la station 802.11 a correctement transmises après plusieurs tentatives de retransmission.
Pour les paquets MSDU, le pilote miniport doit incrémenter ce compteur pour chaque paquet transmis avec succès après une ou plusieurs de ses fragments MPDU requis.
ullMaxTXLifetimeExceededCount
Nombre de paquets MSDU et de trames MMPDU que la station 802.11 n’a pas pu transmettre en raison d’un délai d’expiration tel que défini par l’IEEE 802.11 dot11MaxTransmitMSDULifetime objet MIB. Pour plus d’informations sur cet objet MIB, consultez OID_DOT11_MAX_TRANSMIT_MSDU_LIFETIME.
ullTransmittedFragmentCount
Nombre d’images MPDU transmises par la station 802.11 et reconnue par le biais d’une trame ACK de 802.11 reçue.
ullRTSSuccessCount
Nombre de fois où la station 802.11 a reçu une trame Clear To Send (CTS) en réponse à une trame De demande d’envoi (RTS).
ullRTSFailureCount
Nombre de fois où la station 802.11 n’a pas reçu de trame CTS en réponse à une trame RTS.
ullACKFailureCount
Nombre de fois que la station 802.11 était attendue et qu’elle n’avait pas reçu de cadre d’accusé de réception (ACK).
ullReceivedFrameCount
Nombre total de paquets MSDU et de trames MMPDU que la station 802.11 a correctement reçues.
Pour les paquets MSDU, le pilote miniport doit incrémenter ce compteur pour chaque paquet dont les fragments MPDU ont été reçus et transmis la vérification et la détection de relecture des images. Le pilote miniport doit incrémenter ce membre, que le paquet MSDU reçu ou le fragment MPDU échouent au déchiffrement de chiffrement de la couche MAC.
Ce compteur est facultatif. Si la carte réseau ne prend pas en charge ce compteur, le pilote miniport doit définir ce membre sur DOT11_STATISTICS_UNKNOWN.
ullMulticastReceivedFrameCount
Nombre de paquets MSDU de multidiffusion ou de diffusion et de trames MMPDU reçues par la station 802.11.
Pour les paquets MSDU, le pilote miniport doit incrémenter ce compteur pour chaque paquet dont les fragments MPDU ont été reçus et transmis la vérification fcS et la détection de relecture. Le pilote miniport doit incrémenter ce membre, que le paquet MSDU reçu ou le fragment MPDU échouent au déchiffrement de chiffrement de la couche MAC.
Ce compteur est facultatif. Si la carte réseau ne prend pas en charge ce compteur, le pilote miniport doit définir ce membre sur DOT11_STATISTICS_UNKNOWN.
ullPromiscuousReceivedFrameCount
Nombre de paquets MSDU ou de trames MMPDU reçues par la station 802.11 lorsqu’un filtre de paquets promiscueux est activé. Pour plus d’informations sur les filtres de paquets, consultez OID_GEN_CURRENT_PACKET_FILTER.
Si un filtre de paquets promiscues est activé, le pilote miniport doit uniquement incrémenter ce compteur pour les paquets MSDU reçus ou les images MMPDU qui auraient été rejetées si le filtre n’a pas été activé. Le pilote ne doit pas incrémenter ce compteur pour :
- Paquets MSDU monodiffusion ou trames MMPDU avec une adresse MAC de destination qui correspond à l’adresse MAC de la station 802.11.
- Multidiffusion ou diffusion de paquets MSDU ou de trames MMPDU avec une adresse MAC de destination 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.
ullMaxRXLifetimeExceededCount
Nombre si les paquets MSDU et les images MMPDU ignorées par la station 802.11 en raison d’un délai d’expiration tel que défini par l’IEEE 802.11 dot11MaxReceiveLifetime objet MIB. Pour plus d’informations sur cet objet MIB, consultez OID_DOT11_MAX_RECEIVE_LIFETIME.
ullFrameDuplicateCount
Nombre d’images MPDU dupliquées reçues par la station 802.11. La station 802.11 détermine les images dupliquées via le champ Contrôle de séquence de l’en-tête MAC 802.11.
ullReceivedFragmentCount
Nombre d’images MPDU reçues par la station 802.11 pour les paquets MSDU ou les images MMPDU.
ullPromiscuousReceivedFragmentCount
Nombre d’images MPDU reçues par la station 802.11 pour les paquets MSDU ou les images MMPDU lorsqu’un filtre de paquets promiscues a été activé. Pour plus d’informations sur les filtres de paquets, consultez OID_GEN_CURRENT_PACKET_FILTER.
Si un filtre de paquets promiscues est activé, le pilote miniport doit uniquement incrémenter ce compteur pour les images MPDU reçues qui auraient été rejetées si le filtre n’a pas été activé. Le pilote ne doit pas incrémenter ce compteur pour :
- Images MPDU monodiffusion avec une adresse MAC de destination qui correspond à l’adresse MAC de la station 802.11.
- Multidiffusion ou diffusion de trames MPDU avec une adresse MAC de destination 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.
ullFCSErrorCount
Nombre d’images MPDU reçues par la station 802.11 avec des erreurs FCS.
Remarques
Les membres de cette structure sont utilisés pour enregistrer les statistiques de niveau PHY 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) |