Share via

DOT11_STATISTICS (Compact 7)

  • Article

3/12/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.

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[];
} 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

    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.

    Note

    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.

    Note

    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.

Requirements

Header

windot11.h

See Also

Reference

Native 802.11 Data Types
OID_DOT11_STATISTICS
NDIS_OBJECT_HEADER
DOT11_MAC_FRAME_STATISTICS
OID_DOT11_MULTICAST_LIST
DOT11_PHY_FRAME_STATISTICS
OID_DOT11_SUPPORTED_PHY_TYPES
Native 802.11 Wireless LAN Reference