Hardware Dev Center

Collapse the table of content
Expand the table of content
Expand Minimize

DOT11_PEER_INFO structure

The DOT11_PEER_INFO structure specifies information on a peer station within an independent basic service set (IBSS) network.

Note  IBSS (Ad hoc) and SoftAP are deprecated. Starting with Windows 8.1 and Windows Server 2012 R2, use Wi-Fi Direct.
 

Syntax


typedef struct _DOT11_PEER_INFO {
  DOT11_MAC_ADDRESS       MacAddress;
  USHORT                  usCapabilityInformation;
  DOT11_AUTH_ALGORITHM    AuthAlgo;
  DOT11_CIPHER_ALGORITHM  UnicastCipherAlgo;
  DOT11_CIPHER_ALGORITHM  MulticastCipherAlgo;
  BOOLEAN                 bWpsEnabled;
  USHORT                  usListenInterval;
  UCHAR                   ucSupportedRates[MAX_NUM_SUPPORTED_RATES_V2];
  USHORT                  usAssociationID;
  DOT11_ASSOCIATION_STATE AssociationState;
  DOT11_POWER_MODE        PowerMode;
  LARGE_INTEGER           liAssociationUpTime;
  DOT11_PEER_STATISTICS   Statistics;
} DOT11_PEER_INFO, *PDOT11_PEER_INFO;

Members

MacAddress

The media access control (MAC) address of the peer station within an independent BSS (IBSS) network.

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.

AuthAlgo

The authentication algorithm that the 802.11 station resolved with the peer station during the association operation. For more information about the data type for the AuthAlgo member, see DOT11_AUTH_ALGORITHM.

This member is not defined if the peer is not associated.

UnicastCipherAlgo

The unicast cipher algorithm that the 802.11 station resolved with the peer station during the association operation. For more information about the data type for the UnicastCipherAlgo member, see DOT11_CIPHER_ALGORITHM.

This member is not defined if the peer is not associated.

MulticastCipherAlgo

The multicast cipher algorithm that the 802.11 station resolved with the peer station during the association operation. For more information about the data type for the MulticastCipherAlgo member, see DOT11_CIPHER_ALGORITHM.

This member is not defined if the peer is not associated.

bWpsEnabled

A Boolean value that indicates whether WiFi Protected Setup (WPS) is enabled for the peer station. If TRUE, WPS is enabled, and the authentication and cipher algorithms that are used by the peer might be different from the algorithms that are enabled on the AP.

This member should not be used if the peer is not associated.

usListenInterval

A USHORT value that defines the 802.11 Listen Interval field that was obtained from the association request.

This member has a value of zero if the peer is not associated.

ucSupportedRates

A UCHAR value that specifies the data rates supported by the peer station. These rates are based on the 802.11 Supported Rates IE 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.

This member has a value of zero if the peer is not associated.

usAssociationID

A USHORT value that specifies the 802.11 Association ID field from the association or re-association response frames that the 802.11 station received from the AP.

This member has a value of 0xFFFF if the peer is not associated.

AssociationState

A DOT11_ASSOCIATION_STATE-type value that indicates the 802.11 authentication and association state of the peer station. The state can be either dot11_assoc_state_auth_unassoc or dot11_assoc_state_auth_assoc.

In the IEEE 802.11 Standard, the 802.11 authentication procedure is optional for an independent network. Therefore, depending upon the IHV implementation, the state represented by the dot11_assoc_state_auth_unassoc enumeration value may not be applicable.

PowerMode

A DOT11_POWER_MODE-type value that describes the latest power management mode of the peer station.

liAssociationUpTime

A LARGEINTEGER value that species the timestamp when the 802.11 association procedure successfully completed. The miniport driver calls NdisGetCurrentSystemTime to get the timestamp of the association completion.

This member has a value of zero if the peer is not associated.

Statistics

The statistics counters for data traffic, defined by the DOT11_PEER_STATISTICS structure.

This member has a value of zero if the peer is not associated.

Requirements

Version

Available in Windows 7 and later versions of the Windows operating systems.

Header

Windot11.h (include Ndis.h)

See also

DOT11_ASSOCIATION_STATE
DOT11_PEER_INFO_LIST
DOT11_PEER_STATISTICS
DOT11_POWER_MODE
NDIS_OBJECT_HEADER
NdisGetCurrentSystemTime

 

 

Send comments about this topic to Microsoft

Show:
© 2015 Microsoft