DOT11_EXTSTA_CAPABILITY (Compact 2013)

3/26/2014

This structure is used when the miniport driver is requested to return the sizes of various tables and lists that are supported by the 802.11 station.


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;

Header

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

uScanSSIDListSize

The maximum number of service set identifiers (SSIDs) that are 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) that is supported by the 802.11 station. The 802.11 station must support a BSSID list that has 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 that is supported by the 802.11 station. The 802.11 station must support a desired SSID list that has 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 that is supported by the 802.11 station. The 802.11 station must support an excluded MAC address list that has 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 that has 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 enumerator values that are 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 that is 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.

Header

windot11.h

Show: