DOT11_PHY_FRAME_STATISTICS (Compact 2013)

  • Article

3/26/2014

This structure records statistical counters for the IEEE physical (PHY) layer of the 802.11 station.

Syntax

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;

Members

  • ullTransmittedFrameCount
    The number of MSDU packets and MMPDU frames that the IEEE PHY layer of the 802.11 station has successfully transmitted.
  • ullMulticastTransmittedFrameCount
    The number of multicast or broadcast MSDU packets and MMPDU frames that the IEEE PHY layer of the 802.11 station has successfully transmitted.
  • ullFailedCount
    The number of MSDU packets and MMPDU frames that the 802.11 station did not transmit after exceeding the retry limits defined by the 802.11 IEEE dot11ShortRetryLimit or dot11LongRetryLimit MIB counters. For more information about these MIB counters, see OID_DOT11_SHORT_RETRY_LIMIT and OID_DOT11_LONG_RETRY_LIMIT.
  • ullRetryCount
    The number of MSDU packets and MMPDU frames that the 802.11 station successfully transmitted after one or more tries.

  • ullMultipleRetryCount
    The number of MSDU packets and MMPDU frames that the 802.11 station successfully transmitted after more than one retransmission attempt.

    For MSDU packets, the miniport driver must increment this counter for each packet that was transmitted successfully after one or more of its MPDU fragments required retransmission.

  • ullMaxTXLifetimeExceededCount
    The number of MSDU packets and MMPDU frames that the 802.11 station did not transmit because of a time-out as defined by the IEEE 802.11 dot11MaxTransmitMSDULifetime MIB object. For more information about this MIB object, see OID_DOT11_MAX_TRANSMIT_MSDU_LIFETIME.
  • ullTransmittedFragmentCount
    The number of MPDU frames that the 802.11 station transmitted and acknowledged through a received 802.11 ACK frame.
  • ullRTSSuccessCount
    The number of times that the 802.11 station received a Clear To Send (CTS) frame in response to a Request To Send (RTS) frame.
  • ullRTSFailureCount
    The number of times that the 802.11 station did not receive a CTS frame in response to an RTS frame.
  • ullACKFailureCount
    The number of times that the 802.11 station expected and did not receive an Acknowledgement (ACK) frame.

  • ullReceivedFrameCount
    The total number of MSDU packets and MMPDU frames that the 802.11 station has successfully received.

    For MSDU packets, the miniport driver must increment this counter for each packet whose MPDU fragments were received and passed frame check sequence (FCS) verification and replay detection. The miniport driver must increment this member regardless of whether the received MSDU packet or MPDU fragment fail MAC-layer cipher decryption.

    This counter is optional. If the network adapter does not support this counter, the miniport driver should set this member to DOT11_STATISTICS_UNKNOWN.

  • ullMulticastReceivedFrameCount
    The number of multicast or broadcast MSDU packets and MMPDU frames that the 802.11 station has successfully received.

    For MSDU packets, the miniport driver must increment this counter for each packet whose MPDU fragments were received and passed FCS verification and replay detection. The miniport driver must increment this member regardless of whether the received MSDU packet or MPDU fragment fail MAC-layer cipher decryption.

    This counter is optional. If the network adapter does not support this counter, the miniport driver should set this member to DOT11_STATISTICS_UNKNOWN.

  • ullPromiscuousReceivedFrameCount
    The number of MSDU packets or MMPDU frames received by the 802.11 station when a promiscuous packet filter is enabled. For more information about packet filters, see OID_GEN_CURRENT_PACKET_FILTER.

    If a promiscuous packet filter is enabled, the miniport driver must only increment this counter for received MSDU packets or MMPDU frames that would have been rejected if the filter was not enabled. The driver must not increment this counter for:

    • Unicast MSDU packets or MMPDU frames with a destination MAC address that matches the 802.11 station’s MAC address
    • Multicast or broadcast MSDU packets or MMPDU frames with a destination MAC address that matches an entry in the multicast address list of the 802.11 station. For more information about the multicast address list, see OID_DOT11_MULTICAST_LIST.
  • ullMaxRXLifetimeExceededCount
    The number if MSDU packets and MMPDU frames that the 802.11 station discarded because of a time-out as defined by the IEEE 802.11 dot11MaxReceiveLifetime MIB object. For more information about this MIB object, see OID_DOT11_MAX_RECEIVE_LIFETIME.
  • ullFrameDuplicateCount
    The number of duplicate MPDU frames that the 802.11 station received. The 802.11 station determines duplicate frames through the Sequence Control field of the 802.11 MAC header.
  • ullReceivedFragmentCount
    The number of MPDU frames received by the 802.11 station for MSDU packets or MMPDU frames.

  • ullPromiscuousReceivedFragmentCount
    The number of MPDU frames received by the 802.11 station for MSDU packets or MMPDU frames when a promiscuous packet filter was enabled.

    If a promiscuous packet filter is enabled, the miniport driver must only increment this counter for received MPDU frames that would have been rejected if the filter was not enabled. The driver must not increment this counter for:

    • Unicast MPDU frames with a destination MAC address that matches the 802.11 station’s MAC address
    • Multicast or broadcast MPDU frames with a destination MAC address that matches an entry in the multicast address list of the 802.11 station
  • ullFCSErrorCount
    The number of MPDU frames that have FCS errors that the 802.11 station received

Remarks

The members of this structure are used to record PHY-level statistics for:

  • 802.11 MSDU packets
  • 802.11 MMPDU frames
  • 802.11 MPDU frames. MPDU frame counters must include all MPDU fragments that were sent for an MSDU packet or MMPDU frame

Requirements

Header

windot11.h

See Also

Reference

Native 802.11 Data Types
OID_DOT11_SHORT_RETRY_LIMIT
OID_DOT11_LONG_RETRY_LIMIT
OID_DOT11_MAX_TRANSMIT_MSDU_LIFETIME
OID_GEN_CURRENT_PACKET_FILTER
OID_DOT11_MULTICAST_LIST
OID_DOT11_MAX_RECEIVE_LIFETIME
Native 802.11 Wireless LAN Reference