Export (0) Print
Expand All
Expand Minimize

DOT11_ASSOCIATION_INFO_EX (Compact 2013)

3/26/2014

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


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;

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.

Header

windot11.h

Show:
© 2015 Microsoft