DOT11_ASSOCIATION_INFO_EX (Compact 2013)

3/26/2014

This structure describes the data types for the entries in the dot11AssocInfo array.

Syntax

typedef struct DOT11_ASSOCIATION_INFO_EX 
{
  DOT11_MAC_ADDRESS  PeerMacAddress;
  DOT11_MAC_ADDRESS  BSSID;
  USHORT  usCapabilityInformation;
  USHORT  usListenInterval;
  UCHAR  ucPeerSupportedRates[MAX_NUM_SUPPORTED_RATES_V2];
  USHORT  usAssociationID;
  DOT11_ASSOCIATION_STATE  dot11AssociationState;
  DOT11_POWER_MODE  dot11PowerMode;
  LARGE_INTEGER  liAssociationUpTime;
  ULONGLONG  ullNumOfTxPacketSuccesses;
  ULONGLONG  ullNumOfTxPacketFailures;
  ULONGLONG  ullNumOfRxPacketSuccesses;
  ULONGLONG  ullNumOfRxPacketFailures;
} DOT11_ASSOCIATION_INFO_EX, *PDOT11_ASSOCIATION_INFO_EX;

Members

• PeerMacAddress
  The MAC address of the AP or peer station

• BSSID
  The BSS identifier (BSSID). The BSSID is one of the following identifiers:

  • The MAC address of the AP
  • The BSSID of the IBSS network to which the peer station is connected

• usCapabilityInformation
  The 802.11 Capability Information field from the Beacon or Probe Response frames that the 802.11 station most recently received from the peer

• usListenInterval
  The 802.11 Listen Interval field from the Association Request or Reassociation Request frames that the 802.11 station sent to the AP.

  If the desired BSS type is dot11_BSS_type_independent, the miniport driver must set this member to zero.

• ucPeerSupportedRates
  The data rates supported by the AP or peer station. These rates are based on the 802.11 Supported Rates Information Element from the Beacon or Probe Response frames that the 802.11 station most recently received from the peer.

  Each entry in the ucPeerSupportedRates array is the value of an index within the table of data rates returned through a query of OID_DOT11_DATA_RATE_MAPPING_TABLE. The index value must be between 2 and 127.

• usAssociationID
  The 802.11 Association ID field from the Association or Reassociation Response frames that the 802.11 received from the AP.

  If the desired BSS type is dot11_BSS_type_independent, the miniport driver must set this member to zero.

• Dot11AssociationState
  The 802.11 authentication and association state of the peer. The data type for this member is the DOT11_ASSOCIATION_STATE enumeration:

  dot11_assoc_state_auth_unassoc	The 802.11 station is authenticated, but not associate, with the peer
  dot11_assoc_state_auth_assoc	The 802.11 station is authenticated and associated with the peer

  If the desired BSS type is dot11_BSS_type_independent, the miniport driver must not set this member to dot11_assoc_state_auth_assoc. Because the 802.11 authentication procedure is optional for IBSSs, the miniport driver can set this member to dot11_assoc_state_unauth_unassoc even though it is connected to an IBSS network.

• Dot11PowerMode
  Power management mode of the peer. For more information about this structure, see DOT11_POWER_MODE.

  If the desired BSS type is dot11_BSS_type_infrastructure, the miniport driver must set this member to dot11_power_mode_active.

• liAssociationUpTime
  The time stamp when the 802.11 association procedure successfully completed. The miniport driver calls NdisGetCurrentSystemTime to obtain the time stamp of the association completion.

  If the desired BSS type is dot11_BSS_type_independent, the miniport driver must set this member to zero.

• ullNumOfTxPacketSuccesses
  The number of 802.11 MAC protocol data unit (MPDU), management MPDU (MMPDU), and control frames successfully transmitted to the peer

• ullNumOfTxPacketFailures
  The number of 802.11 MPDU, MMPDU, and control frames that failed during transmission to the peer

• ullNumOfRxPacketSuccesses
  The number of 802.11 MPDU, MMPDU, and control frames successfully received from the peer

• ullNumOfRxPacketFailures
  The number of 802.11 MPDU, MMPDU, and control frames that the 802.11 did not receive from the peer. This counter must include packets that the 802.11 station received successfully but did not decrypt.

Requirements

Header

windot11.h

See Also

Reference

Native 802.11 Data Types
DOT11_ASSOCIATION_INFO_LIST
OID_DOT11_ENUM_ASSOCIATION_INFO
OID_DOT11_DATA_RATE_MAPPING_TABLE
DOT11_POWER_MODE
NdisGetCurrentSystemTime
Native 802.11 Wireless LAN Reference