DOT11_PHY_FRAME_STATISTICS structure (windot11.h)
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 transmis avec succès.
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 nouvelles tentatives définies par les compteurs MIB 802.11 IEEE dot11ShortRetryLimit ou dot11LongRetryLimit . 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 transmis après une ou plusieurs tentatives.
ullMultipleRetryCount
Nombre de paquets MSDU et de trames MMPDU que la station 802.11 a correctement transmis après plusieurs tentatives de retransmission.
Pour les paquets MSDU, le pilote miniport doit incrémenter ce compteur pour chaque paquet qui a été transmis correctement après qu’un ou plusieurs de ses fragments MPDU ont nécessité une retransmission.
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 défini par l’objet MIB IEEE 802.11 dot11MaxTransmitMSDULifetime . Pour plus d’informations sur cet objet MIB, consultez OID_DOT11_MAX_TRANSMIT_MSDU_LIFETIME.
ullTransmittedFragmentCount
Nombre de trames MPDU que la station 802.11 a transmises et reconnues par le biais d’une trame ACK 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 RTS (Request To Send).
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 où la station 802.11 s’attendait et n’a pas reçu de trame d’accusé de réception (ACK).
ullReceivedFrameCount
Nombre total de paquets MSDU et de trames MMPDU que la station 802.11 a reçus avec succès.
Pour les paquets MSDU, le pilote miniport doit incrémenter ce compteur pour chaque paquet dont les fragments MPDU ont été reçus et passé la vérification de la séquence de trame case activée (FCS) et la détection de relecture. Le pilote miniport doit incrémenter ce membre, que le paquet MSDU ou le fragment MPDU reçu échouent au déchiffrement du 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 que la station 802.11 a reçus avec succès.
Pour les paquets MSDU, le pilote miniport doit incrémenter ce compteur pour chaque paquet dont les fragments MPDU ont été reçus et a passé la vérification FCS et la détection de relecture. Le pilote miniport doit incrémenter ce membre, que le paquet MSDU ou le fragment MPDU reçu échouent au déchiffrement du 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 de promiscuité est activé. Pour plus d’informations sur les filtres de paquets, consultez OID_GEN_CURRENT_PACKET_FILTER.
Si un filtre de paquets promiscueux est activé, le pilote miniport doit uniquement incrémenter ce compteur pour les paquets MSDU reçus ou les trames MMPDU qui auraient été rejetées si le filtre n’avait pas été activé. Le pilote ne doit pas incrémenter ce compteur pour :
- Monodiffusion de paquets MSDU 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 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 de paquets MSDU et de trames MMPDU que la station 802.11 a ignorés en raison d’un délai d’expiration défini par l’objet MIB IEEE 802.11 dot11MaxReceiveLifetime . Pour plus d’informations sur cet objet MIB, consultez OID_DOT11_MAX_RECEIVE_LIFETIME.
ullFrameDuplicateCount
Nombre de trames MPDU en double que la station 802.11 a reçues. La station 802.11 détermine les images en double via le champ Contrôle de séquence de l’en-tête MAC 802.11.
ullReceivedFragmentCount
Nombre de trames MPDU reçues par la station 802.11 pour les paquets MSDU ou les trames MMPDU.
ullPromiscuousReceivedFragmentCount
Nombre de trames MPDU reçues par la station 802.11 pour les paquets MSDU ou les trames MMPDU lorsqu’un filtre de paquets de promiscuité a été activé. Pour plus d’informations sur les filtres de paquets, consultez OID_GEN_CURRENT_PACKET_FILTER.
Si un filtre de paquets de promiscuité 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’était pas activé. Le pilote ne doit pas incrémenter ce compteur pour :
- Monodiffusion de trames MPDU avec une adresse MAC de destination qui correspond à l’adresse MAC de la station 802.11.
- Trames MPDU de multidiffusion ou de diffusion 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 de trames 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 :
- Paquets MSDU 802.11.
- Images MMPDU 802.11.
- 802.11 Images MPDU. Les compteurs d’images MPDU doivent inclure tous les fragments MPDU envoyés pour un paquet MSDU ou un frame MMPDU
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) |