DOT11_PHY_FRAME_STATISTICS structure (windot11.h)

Important  The Native 802.11 Wireless LAN interface is deprecated in Windows 10 and later. Please use the WLAN Device Driver Interface (WDI) instead. For more information about WDI, see WLAN Universal Windows driver model.
 
The DOT11_PHY_FRAME_STATISTICS 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 failed to 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 or 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 attempts.

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 failed to transmit because of a timeout 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 NIC 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 NIC 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 timeout 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. 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 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. For more information about the multicast address list, see OID_DOT11_MULTICAST_LIST.

ullFCSErrorCount

The number of MPDU frames that the 802.11 station received with FCS errors.

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 sent for an MSDU packet or MMPDU frame

Requirements

Requirement Value
Minimum supported client Available in Windows Vista and later versions of the Windows operating systems.
Header windot11.h (include Ndis.h)

See also

Extensible Station PHY Statistics

OID_DOT11_STATISTICS

DOT11_STATISTICS

Native 802.11 Statistics