DOT11_ASSOCIATION_PARAMS structure (windot11.h)

Article
03/15/2022

Important The Native 802.11 Wireless LAN interface is deprecated in Windows 10 and later. Please use the WLAN Device Driver Interface (WDI) instead. For more information about WDI, see WLAN Universal Windows driver model.

The DOT11_ASSOCIATION_PARAMS structure specifies the list of additional information elements (IEs) that the miniport driver appends to the association request that the NIC sends to an access point in an infrastructure BSS network.

Syntax

typedef struct DOT11_ASSOCIATION_PARAMS {
  NDIS_OBJECT_HEADER Header;
  DOT11_MAC_ADDRESS  BSSID;
  ULONG              uAssocRequestIEsOffset;
  ULONG              uAssocRequestIEsLength;
} DOT11_ASSOCIATION_PARAMS, *PDOT11_ASSOCIATION_PARAMS;

Members

Header

The type, revision, and size of the DOT11_ASSOCIATION_PARAMS 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

This member must be set to DOT11_ASSOCIATION_PARAMS_REVISION_1.

Size

This member must be set to sizeof(DOT11_ASSOCIATION_PARAMS).

For more information about these members, see NDIS_OBJECT_HEADER.

BSSID

The basic service set (BSS) identifier (BSSID) of the infrastructure BSS network for which the association parameters are to be set.

The miniport driver should add new additional information elements (IEs) to an association request only if it is attempting to associate with an access point that has the matching BSSID.

If this member is set to the wildcard BSSID (0xFFFFFFFFFFFF), the miniport driver should add new additional information elements (IEs) to association requests for all access points that have valid BSSIDs.

uAssocRequestIEsOffset

The offset of the additional IEs, in bytes, that the operating system requests be added to the association response. This offset is relative to the start of the buffer that contains the DOT11_ASSOCIATION_PARAMS structure. The default value is 0.

uAssocRequestIEsLength

The length of the additional IEs, in bytes, that the operating system requests be added to the association response. The default value is 0.

Remarks

This structure is used with OID_DOT11_ASSOCIATION_PARAMS.

Requirements

Requirement	Value
Minimum supported client	Available in Windows 7 and later versions of the Windows operating systems.
Header	windot11.h (include Ndis.h)