DOT11_EXTSTA_ATTRIBUTES structure (windot11.h)
Important
WiFiCx is the new Wi-Fi driver model released in Windows 11. We recommend that you use WiFiCx to take advantage of the latest features. The WDI driver model is now in maintenance mode and will only receive high priority fixes.
The DOT11_EXTSTA_ATTRIBUTES structure defines the physical and operating attributes of the miniport driver and 802.11 station when operating in Extensible Station (ExtSTA) mode. For more information about this operation mode, see Extensible Station Operation Mode.
Syntax
typedef struct DOT11_EXTSTA_ATTRIBUTES {
NDIS_OBJECT_HEADER Header;
ULONG uScanSSIDListSize;
ULONG uDesiredBSSIDListSize;
ULONG uDesiredSSIDListSize;
ULONG uExcludedMacAddressListSize;
ULONG uPrivacyExemptionListSize;
ULONG uKeyMappingTableSize;
ULONG uDefaultKeyTableSize;
ULONG uWEPKeyValueMaxLength;
ULONG uPMKIDCacheSize;
ULONG uMaxNumPerSTADefaultKeyTables;
BOOLEAN bStrictlyOrderedServiceClassImplemented;
UCHAR ucSupportedQoSProtocolFlags;
BOOLEAN bSafeModeImplemented;
ULONG uNumSupportedCountryOrRegionStrings;
PDOT11_COUNTRY_OR_REGION_STRING pSupportedCountryOrRegionStrings;
ULONG uInfraNumSupportedUcastAlgoPairs;
PDOT11_AUTH_CIPHER_PAIR pInfraSupportedUcastAlgoPairs;
ULONG uInfraNumSupportedMcastAlgoPairs;
PDOT11_AUTH_CIPHER_PAIR pInfraSupportedMcastAlgoPairs;
ULONG uAdhocNumSupportedUcastAlgoPairs;
PDOT11_AUTH_CIPHER_PAIR pAdhocSupportedUcastAlgoPairs;
ULONG uAdhocNumSupportedMcastAlgoPairs;
PDOT11_AUTH_CIPHER_PAIR pAdhocSupportedMcastAlgoPairs;
BOOLEAN bAutoPowerSaveMode;
ULONG uMaxNetworkOffloadListSize;
BOOLEAN bMFPCapable;
ULONG uInfraNumSupportedMcastMgmtAlgoPairs;
PDOT11_AUTH_CIPHER_PAIR pInfraSupportedMcastMgmtAlgoPairs;
} DOT11_EXTSTA_ATTRIBUTES, *PDOT11_EXTSTA_ATTRIBUTES;
Members
Header
The type, revision, and size of the DOT11_EXTSTA_ATTRIBUTES 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 one of the following values according to the operating system that the driver is intended to run on:
DOT11_EXTSTA_ATTRIBUTES_REVISION_1
Windows Vista
DOT11_EXTSTA_ATTRIBUTES_REVISION_2
Windows Vista with Service Pack 1 (SP1) or later versions of the Windows operating systems
DOT11_EXTSTA_ATTRIBUTES_REVISION_3
Windows 8 or later versions of the Windows operating systems
These values determine how the operating system interprets the bSafeModeImplemented member.
Size
This member must be set to sizeof(DOT11_EXTSTA_ATTRIBUTES).
For more information about these members, see NDIS_OBJECT_HEADER.
uScanSSIDListSize
The maximum number of service set identifiers (SSIDs) supported by the 802.11 station for scan operations. The 802.11 station must support an SSID list of at least four entries.
The SSID list that the 802.11 station uses for scanning is specified when OID_DOT11_SCAN_REQUEST is set.
uDesiredBSSIDListSize
The maximum number of entries in the desired list of basic service set identifiers (BSSIDs) supported by the 802.11 station. The 802.11 station must support a BSSID list with at least one entry.
For more information about the desired BSSID list, see OID_DOT11_DESIRED_BSSID_LIST.
uDesiredSSIDListSize
The maximum number of entries in the desired SSID list supported by the 802.11 station. The 802.11 station must support a desired SSID list with at least one entry.
For more information about the desired SSID list, see OID_DOT11_DESIRED_SSID_LIST.
uExcludedMacAddressListSize
The maximum number of entries in the excluded MAC address list supported by the 802.11 station. The 802.11 station must support an excluded MAC address list with at least four entries.
For more information about the desired excluded MAC address list, see OID_DOT11_EXCLUDED_MAC_ADDRESS_LIST.
uPrivacyExemptionListSize
The maximum number of entries in the privacy exemption list supported by the 802.11 station. The 802.11 station must support a privacy exemption list with at least one entry.
For more information about the privacy exemption list, see OID_DOT11_PRIVACY_EXEMPTION_LIST.
uKeyMappingTableSize
The maximum number of cipher key-mapping keys supported by the 802.11 station. It is recommended that the 802.11 station support at least 32 key-mapping keys.
For more information about key mapping keys, see OID_DOT11_CIPHER_KEY_MAPPING_KEY.
uDefaultKeyTableSize
The maximum number of cipher keys the 802.11 station supports for the default key and per-station default key tables.
For standard 802.11 cipher algorithms, the 802.11 station must support a table size of at least four cipher keys. For cipher algorithms developed by the independent hardware vendor (IHV), the table size can be four or greater.
uWEPKeyValueMaxLength
The maximum length, in bytes, of a WEP cipher key supported by the 802.11 station.
The following table lists the minimum and maximum key lengths, in bytes, for the various WEP cipher values defined through DOT11_CIPHER_ALGORITHM.
| WEP cipher | Minimum key length | Maximum key length |
|---|---|---|
| DOT11_CIPHER_ALGO_WEP40 | 5 | 5 |
| DOT11_CIPHER_ALGO_WEP104 | 13 | 13 |
| DOT11_CIPHER_ALGO_WEP | 13 | Any length supported by the 802.11 station |
uPMKIDCacheSize
The maximum number of entries in the pairwise master key identifier (PMKID) cache supported by the 802.11 station.
If the 802.11 station does not support a PMKID cache, the miniport driver must set this member to zero. Otherwise, the 802.11 station must support a PMKID cache size of at least three entries.
For more information about the PMKID cache, see OID_DOT11_PMKID_LIST.
uMaxNumPerSTADefaultKeyTables
The maximum number of per-station default cipher key tables supported by the 802.11 station. It is recommended that the 802.11 station support at least 32 per-station default cipher key tables.
For more information about per-station default cipher key tables, see Per-Station Default Keys.
bStrictlyOrderedServiceClassImplemented
A Boolean value that, if set to TRUE, specifies that the 802.11 station supports the IEEE 802.11 StrictlyOrdered service class for media access control (MAC) service data unit (MSDU) packet delivery.
For more information about the StrictlyOrdered service class, refer to Clause 5.1.3 of the IEEE 802.11-2012 standard.
ucSupportedQoSProtocolFlags
A set of flags that specify the quality of service (QoS) protocols that the NIC implements. This member is either zero or a bitwise OR combination of the following flags:
DOT11_QOS_PROTOCOL_FLAG_WMM
The NIC implements the 802.11 WMM QoS protocol.
DOT11_QOS_PROTOCOL_FLAG_11E
The NIC implements the 802.11e QoS protocol.
bSafeModeImplemented
The safe mode support capability of the NIC/miniport driver combination. The operating system interprets this member differently depending on the value of Header.Revision:
Revision = DOT11_EXTSTA_ATTRIBUTES_REVISION_1
The operating system interprets the bSafeModeImplemented member as a Boolean value. If this value is TRUE, the NIC implements the 802.11 safe mode of operation. Otherwise, the value is FALSE.
Revision = DOT11_EXTSTA_ATTRIBUTES_REVISION_2 or higher
The operating system interprets the bSafeModeImplemented member as a bit field with the following possible bit values set:
- If the bit field is set to DOT11_EXTSTA_ATTRIBUTES_SAFEMODE_OID_SUPPORTED with no other bits set, the miniport driver implements the 802.11 safe mode of operation.
- If the bit field is set to DOT11_EXTSTA_ATTRIBUTES_SAFEMODE_CERTIFIED, the NIC/miniport combination has received a validation certificate from the National Institute of Standards and Technology (NIST) under Federal Information Processing Standards (FIPS) Publication 140-2, Security Requirements for Cryptographic Modules.
uNumSupportedCountryOrRegionStrings
The number of country or region strings supported by the 802.11 station. If the 802.11 station supports multiple regulatory domains as specified by the IEEE 802.11d-2001 standard, each country or region string identifies a regulatory domain supported by the 802.11 station.
If the 802.11 station does not support the IEEE 802.11d-2001 standard, the miniport driver must set uNumSupportedCountryOrRegionStrings to zero.
pSupportedCountryOrRegionStrings
A pointer to an array of 802.11d country or region strings that are supported by the 802.11 station. Each entry in the array is formatted as a DOT11_COUNTRY_OR_REGION_STRING structure.
uInfraNumSupportedUcastAlgoPairs
The number of authentication and cipher algorithms supported by the 802.11 station for sending and receiving unicast packets when configured for operation in an infrastructure basic service set (BSS) network. The uInfraNumSupportedUcastAlgoPairs member must be the number of DOT11_AUTH_CIPHER_PAIR structures in the array referenced by the pInfraSupportedUcastAlgoPairs member.
pInfraSupportedUcastAlgoPairs
A pointer to an array of authentication and cipher algorithms supported by the 802.11 station for sending and receiving unicast packets in an infrastructure BSS network. Each entry in the array is formatted as a DOT11_AUTH_CIPHER_PAIR structure.
uInfraNumSupportedMcastAlgoPairs
The number of authentication and cipher algorithms supported by the 802.11 station for sending and receiving multicast and broadcast packets when configured for operation in an infrastructure basic service set (BSS) network. The uInfraNumSupportedMcastAlgoPairs member must be the number of DOT11_AUTH_CIPHER_PAIR structures in the array referenced by the pInfraSupportedMcastAlgoPairs member.
pInfraSupportedMcastAlgoPairs
A pointer to an array of authentication and cipher algorithms supported by the 802.11 station for sending and receiving multicast and broadcast packets in an infrastructure BSS network. Each entry in the array is formatted as a DOT11_AUTH_CIPHER_PAIR structure.
uAdhocNumSupportedUcastAlgoPairs
The number of authentication and cipher algorithms supported by the 802.11 station for sending and receiving unicast packets when configured for operation in an independent BSS (IBSS) network. The uAdhocNumSupportedUcastAlgoPairs member must be the number of DOT11_AUTH_CIPHER_PAIR structures in the array referenced by the pAdhocSupportedUcastAlgoPairs member.
pAdhocSupportedUcastAlgoPairs
A pointer to an array of authentication and cipher algorithms supported by the 802.11 station for sending and receiving unicast packets in an IBSS network. Each entry in the array is formatted as a DOT11_AUTH_CIPHER_PAIR structure.
uAdhocNumSupportedMcastAlgoPairs
The number of authentication and cipher algorithms supported by the 802.11 station for sending and receiving multicast and broadcast packets when configured for operation in an IBSS network. The uAdhocNumSupportedMcastAlgoPairs member must be the number of DOT11_AUTH_CIPHER_PAIR structures in the array referenced by the pAdhocSupportedMcastAlgoPairs member.
pAdhocSupportedMcastAlgoPairs
A pointer to an array of authentication and cipher algorithms supported by the 802.11 station for sending and receiving multicast and broadcast packets in an IBSS network. Each entry in the array is formatted as a DOT11_AUTH_CIPHER_PAIR structure.
bAutoPowerSaveMode
The support capability of the NIC/miniport driver combination to autonomously manage power well, including detection and negotiation of proper Wi-Fi Power Save Mode (PSM) between the device and the Wi-Fi Access Point. NDIS 6.30 compliant Wi-Fi miniport drivers should set this member to TRUE.
uMaxNetworkOffloadListSize
The maximum number of networks a miniport driver can offload, if it has the ability to support the Network List Offload capability.
bMFPCapable
The support capability of the NIC/miniport driver to combination to support management frame protection between the device and the Wi-Fi Access Point as specified in the 802.11w-2009 specification. Set to TRUE if supported. Otherwise, this member should be set to FALSE.
uInfraNumSupportedMcastMgmtAlgoPairs
The length of the array of authentication and cipher algorithm pairs pointed to in pInfraSupportedMcastMgmtAlgoPairs.
pInfraSupportedMcastMgmtAlgoPairs
A pointer to an array of authentication and cipher algorithm pair which the device supports for MFP in Infra mode. The recommended cipher for Windows 8 is BIP with WPA or WPA2 authentication. Each entry in the array is formatted as a DOT11_AUTH_CIPHER_PAIR structure.
bNeighborReportSupported
bAPChannelReportSupported
bActionFramesSupported
bANQPQueryOffloadSupported
bHESSIDConnectionSupported
Remarks
The NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES structure contains a member (pExtSTAAttributes) that specifies the address of a DOT11_EXTSTA_ATTRIBUTES structure. When the miniport driver calls NdisMSetMiniportAttributes, the driver sets the MiniportAttributes parameter to the address of a driver-allocated block of memory which contains an NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES structure along with the DOT11_EXTSTA_ATTRIBUTES structure.
Management Frame Protection Required (MFPR) enforcement on Windows 8 is not supported. Hence miniport drivers should never set this bit in the RSN capabilities of RSN IE during an association request. For policy, the access point may advertise MFPR which will allow MFP-capable STA to associate. Access points not supporting MFP capability will fail association. If MFPR is set by an access point and STA is not MFP capable, Windows 8 will treat the network as mismatched in capability and not send an association request to the miniport.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Available in Windows 8 and later versions of the Windows operating systems. |
| Header | windot11.h (include Ndis.h) |
See also
Extensible Station Operation Mode
OID_DOT11_EXCLUDED_MAC_ADDRESS_LIST DOT11_COUNTRY_OR_REGION_STRING OID_DOT11_PRIVACY_EXEMPTION_LIST OID_DOT11_CIPHER_KEY_MAPPING_KEY NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES