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.
Counters for received unicast packets must only be incremented for those packets with a destination MAC address in the 802.11 MAC header that matches the 802.11 station's MAC address.
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.
Counters for received multicast or broadcast packets must only be incremented for those packets with a destination MAC address in the 802.11 MAC header 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.
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
| Requirement | Value |
|---|---|
| Minimum supported client | Available in Windows Vista and later versions of the Windows operating systems. |
| Header | windot11.h (include Ndis.h) |