DOT11_EXTSTA_ATTRIBUTES (Compact 2013)

  • [アーティクル]

3/26/2014

This structure defines the physical and operating attributes of the miniport driver and 802.11 station when it operates in Extensible Station (ExtSTA) 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;
} 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

    DOT11_EXTSTA_ATTRIBUTES_REVISION_2

    These values determine how the operating system interprets the bSafeModeImplemented member.

    Size

    This member must be set to sizeof(DOT11_EXTSTA_ATTRIBUTES)

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

  • 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 6.1.3 of the IEEE 802.11-1999 standard.

  • ucSupportedQoSProtocolFlags
    A set of flags that specify the quality of service (QoS) protocols that the network adapter implements This member is either zero or a bitwise OR combination of the following flags:

    DOT11_QOS_PROTOCOL_FLAG_WMM

    The network adapter implements the 802.11 WMM QoS protocol.

    DOT11_QOS_PROTOCOL_FLAG_11E

    The network adapter implements the 802.11e QoS protocol.

  • bSafeModeImplemented
    The safe mode support capability of the network adapter/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 network adapter implements the 802.11 safe mode of operation. Otherwise, the value is FALSE.

    Revision = DOT11_EXTSTA_ATTRIBUTES_REVISION_2

    The operating system interprets the bSafeModeImplemented member as a bit field that has 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 network adapter/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.

    This member is used together with OID_DOT11_SAFE_MODE_ENABLED.

  • uNumSupportedCountryOrRegionStrings
    The number of country/region strings that are 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 countr/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/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 that are supported by the 802.11 station for sending and receiving unicast packets when the station is 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
    An array of authentication and cipher algorithms that are 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.
  • uAdhocNumSupportedUcastAlgoPairs
    The number of authentication and cipher algorithms supported by the 802.11 station for sending and receiving unicast packets when it is 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
    An array of authentication and cipher algorithms that are 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 that are supported by the 802.11 station for sending and receiving multicast and broadcast packets when the station is 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
    An array of authentication and cipher algorithms that are 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.

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 that contains an NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES structure together with the DOT11_EXTSTA_ATTRIBUTES structure.

Requirements

Header

windot11.h

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_SAFE_MODE_ENABLED
DOT11_COUNTRY_OR_REGION_STRING
NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES
NdisMSetMiniportAttributes
Native 802.11 Wireless LAN Reference

Other Resources

DOT11_CIPHER_ALGORITHM
DOT11_AUTH_CIPHER_PAIR