OID_DOT11_EXTSTA_CAPABILITY

  • Article

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.

 

When queried, the OID_DOT11_EXTSTA_CAPABILITY object identifier (OID) requests that the miniport driver return the sizes of various tables and lists supported by the 802.11 station.

The data type for this OID is the DOT11_EXTSTA_CAPABILITY structure.

    typedef struct DOT11_EXTSTA_CAPABILITY {
         NDIS_OBJECT_HEADER Header;
         ULONG uScanSSIDListSize;
         ULONG uDesiredBSSIDListSize;
         ULONG uDesiredSSIDListSize;
         ULONG uExcludedMacAddressListSize;
         ULONG uPrivacyExemptionListSize;
         ULONG uKeyMappingTableSize;
         ULONG uDefaultKeyTableSize;
         ULONG uWEPKeyValueMaxLength;
         ULONG uPMKIDCacheSize;
         ULONG uMaxNumPerSTADefaultKeyTables;
    } DOT11_EXTSTA_CAPABILITY, *PDOT11_EXTSTA_CAPABILITY;

This structure includes the following members:

Header
The type, revision, and size of the DOT11_EXTSTA_CAPABILITY 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_EXTSTA_CAPABILITY_REVISION_1.

Size
This member must be set to sizeof(DOT11_EXTSTA_CAPABILITY).

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 more information about default keys and per-station default keys, see 802.11 Cipher Key Types.

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 enumerator 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.

Requirements

Version

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

Header

 Windot11.h (include Ndis.h)

See also

Native 802.11 Wireless LAN OIDs