DOT11_STATISTICS (Compact 2013)

3/26/2014

This structure is used by the OID_DOT11_STATISTICS object identifier (OID) to request that the miniport driver return the statistics for the IEEE 802.11 interface.


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[];
} DOT11_STATISTICS, *PDOT11_STATISTICS;

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

DOT11_STATISTICS_REVISION_1

Size

This member must be set to sizeof(DOT11_STATISTICS)

ullFourWayHandshakeFailures

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

If the 802.11 station is not performing the WPA or RSNA authentication, it must not write to this member.

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 must not write to this member.

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.

Gg157538.note(en-us,WinEmbedded.80).gifNote:
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 that are based on multicast or broadcast packets that are sent or received by the 802.11 station. The data structure for this member is the DOT11_MAC_FRAME_STATISTICS structure.

Gg157538.note(en-us,WinEmbedded.80).gifNote:
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

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

The driver must maintain separate copies of the DOT11_PHY_FRAME_STATISTICS structure for each supported PHY.

The miniport driver returns the list of supported PHYs when queried by OID_DOT11_SUPPORTED_PHY_TYPES.

Header

windot11.h

Show: