DOT11_STATISTICS structure (windot11.h)

The DOT11_STATISTICS structure records statistical counters for the 802.11 interface.

Syntax

typedef struct DOT11_STATISTICS {
  NDIS_OBJECT_HEADER         Header;
  ULONGLONG                  ullFourWayHandshakeFailures;
  ULONGLONG                  ullTKIPCounterMeasuresInvoked;
  ULONGLONG                  ullReserved;
  DOT11_MAC_FRAME_STATISTICS MacUcastCounters;
  DOT11_MAC_FRAME_STATISTICS MacMcastCounters;
  DOT11_PHY_FRAME_STATISTICS PhyCounters[1];
} DOT11_STATISTICS, *PDOT11_STATISTICS;

Members

Header

The type, revision, and size of the DOT11_STATISTICS structure. This member is formatted as an NDIS_OBJECT_HEADER structure.

The miniport driver must set the members of Header to the following values:

Type

This member must be set to NDIS_OBJECT_TYPE_DEFAULT.

Revision

This member must be set to DOT11_STATISTICS_REVISION_1.

Size

This member must be set to sizeof(DOT11_STATISTICS).

For more information about these members, see NDIS_OBJECT_HEADER.

ullFourWayHandshakeFailures

The number of four-way handshake failures that the 802.11 station encountered during Wi-Fi Protected Access (WPA) or Robust Security Network Association (RSNA) authentication.

If the 802.11 station is not performing the WPA or RSNA authentication, it should set this member to DOT11_STATISTICS_UNKNOWN.

ullTKIPCounterMeasuresInvoked

The number of times that the 802.11 station invoked countermeasures following a message integrity code (MIC) failure.

If the 802.11 station is not performing TKIP countermeasures, it should set this member to DOT11_STATISTICS_UNKNOWN.

ullReserved

This member is reserved for use by the operating system. The miniport driver must not write to this member.

MacUcastCounters

The MAC layer counters based on unicast packets sent or received by the 802.11 station. The data structure for this member is the DOT11_MAC_FRAME_STATISTICS structure.

MacMcastCounters

The MAC layer counters based on multicast or broadcast packets sent or received by the 802.11 station. The data structure for this member is the DOT11_MAC_FRAME_STATISTICS structure.

PhyCounters[1]

An array of PHY layer counters. Each entry in this array is formatted as a DOT11_PHY_FRAME_STATISTICS structure.

The miniport driver must maintain an entry within the PhyCounters array for each supported PHY. If the 802.11 station supports multiple PHYs of the same type, the miniport driver must create separate entries for each.

Entries within the PhyCounters array must be in the same order as the list of supported PHYs that the driver returns when queried by OID_DOT11_SUPPORTED_PHY_TYPES.

Remarks

The miniport driver must unconditionally set all of the counters in the DOT11_STATISTICS structure to zero, including MAC-layer and PHY-layer counters, when one of the following occurs:

• The driver's MiniportInitializeEx function is called.
• The driver's MiniportOidRequest function is called with an OID set request of OID_DOT11_RESET_REQUEST, regardless of the type of reset operation specified in the set request.

Requirements

See also

OID_DOT11_STATISTICS