DOT11_EXTSTA_CAPABILITY (Compact 7)

3/12/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.

Syntax

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;

Members

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

Requirements

See Also

Reference

Native 802.11 Data Types
NDIS_OBJECT_HEADER
OID_DOT11_SCAN_REQUEST
OID_DOT11_DESIRED_BSSID_LIST
OID_DOT11_DESIRED_SSID_LIST
OID_DOT11_EXCLUDED_MAC_ADDRESS_LIST
OID_DOT11_PRIVACY_EXEMPTION_LIST
OID_DOT11_CIPHER_KEY_MAPPING_KEY
OID_DOT11_PMKID_LIST
OID_DOT11_EXTSTA_CAPABILITY
Native 802.11 Wireless LAN Reference

Other Resources

DOT11_CIPHER_ALGORITHM