windot11.h) (DOT11_EXTSTA_ATTRIBUTES 结构

重要本机 802.11 无线 LAN 接口在 Windows 10 及更高版本中已弃用。 请改用 WLAN 设备驱动程序接口 (WDI) 。 有关 WDI 的详细信息,请参阅 WLAN 通用 Windows 驱动程序模型
 
在 Extensible Station (ExtSTA) 模式下运行时, DOT11_EXTSTA_ATTRIBUTES 结构定义微型端口驱动程序和 802.11 工作站的物理和操作属性。 有关此操作模式的详细信息,请参阅 可扩展工作站操作模式

语法

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;

成员

Header

DOT11_EXTSTA_ATTRIBUTES 结构的类型、修订和大小。 此成员的格式设置为 NDIS_OBJECT_HEADER 结构。

微型端口驱动程序必须将 Header 的成员设置为以下值。

类型

此成员必须设置为 NDIS_OBJECT_TYPE_DEFAULT

修订

必须根据要运行驱动程序的操作系统将此成员设置为以下值之一:

DOT11_EXTSTA_ATTRIBUTES_REVISION_1

Windows Vista

DOT11_EXTSTA_ATTRIBUTES_REVISION_2

Windows Vista Service Pack 1 (SP1) 或更高版本的 Windows 操作系统

DOT11_EXTSTA_ATTRIBUTES_REVISION_3

Windows 8 或更高版本的 Windows 操作系统

这些值确定操作系统如何解释 bSafeModeImplemented 成员。

大小

此成员必须设置为 sizeof (DOT11_EXTSTA_ATTRIBUTES) 。

有关这些成员的详细信息,请参阅 NDIS_OBJECT_HEADER

uScanSSIDListSize

802.11 工作站) 扫描操作支持的最大服务集标识符 (SSID 数。 802.11 工作站必须支持至少包含四个条目的 SSID 列表。

设置OID_DOT11_SCAN_REQUEST时,指定 802.11 工作站用于扫描 SSID 列表。

uDesiredBSSIDListSize

802.11 工作站) 支持的基本服务集标识符 (所需列表中的最大条目数。 802.11 工作站必须支持至少包含一个条目的 BSSID 列表。

有关所需 BSSID 列表的详细信息,请参阅 OID_DOT11_DESIRED_BSSID_LIST

uDesiredSSIDListSize

802.11 工作站支持的所需 SSID 列表中的最大条目数。 802.11 工作站必须支持至少包含一个条目的所需 SSID 列表。

有关所需 SSID 列表的详细信息,请参阅 OID_DOT11_DESIRED_SSID_LIST

uExcludedMacAddressListSize

802.11 工作站支持的排除 MAC 地址列表中的最大条目数。 802.11 工作站必须支持包含至少四个条目的排除的 MAC 地址列表。

有关所需排除的 MAC 地址列表的详细信息,请参阅 OID_DOT11_EXCLUDED_MAC_ADDRESS_LIST

uPrivacyExemptionListSize

802.11 工作站支持的隐私豁免列表中的最大条目数。 802.11 工作站必须支持至少包含一个条目的隐私豁免列表。

有关隐私豁免列表的详细信息,请参阅 OID_DOT11_PRIVACY_EXEMPTION_LIST

uKeyMappingTableSize

802.11 工作站支持的最大密码键映射密钥数。 建议 802.11 工作站支持至少 32 个键映射键。

有关键映射键的详细信息,请参阅 OID_DOT11_CIPHER_KEY_MAPPING_KEY

uDefaultKeyTableSize

802.11 工作站支持的默认密钥表和每站默认密钥表的密码密钥的最大数目。

对于标准 802.11 密码算法,802.11 工作站必须支持至少四个密码密钥的表大小。 对于独立硬件供应商 (IHV) 开发的密码算法,表大小可以为 4 或更大。

uWEPKeyValueMaxLength

802.11 工作站支持的 WEP 密码密钥的最大长度(以字节为单位)。

下表列出了通过 DOT11_CIPHER_ALGORITHM 定义的各种 WEP 密码值的最小和最大密钥长度 以字节为单位)。

WEP 密码 最小密钥长度 最大密钥长度
DOT11_CIPHER_ALGO_WEP40 5 5
DOT11_CIPHER_ALGO_WEP104 13 13
DOT11_CIPHER_ALGO_WEP 13 802.11 工作站支持的任何长度

uPMKIDCacheSize

802.11 工作站支持的 PMKID) 缓存 (成对主密钥标识符中的最大条目数。

如果 802.11 工作站不支持 PMKID 缓存,微型端口驱动程序必须将此成员设置为零。 否则,802.11 工作站必须支持至少三个条目的 PMKID 缓存大小。

有关 PMKID 缓存的详细信息,请参阅 OID_DOT11_PMKID_LIST

uMaxNumPerSTADefaultKeyTables

802.11 工作站支持的每个工作站默认密码密钥表的最大数目。 建议 802.11 工作站支持至少 32 个每个工作站的默认密码密钥表。

有关每工作站默认密码密钥表的详细信息,请参阅 每工作站默认密钥

bStrictlyOrderedServiceClassImplemented

一个布尔值,如果设置为 TRUE,则指定 802.11 工作站支持 IEEE 802.11 严格排序服务类, (MAC) 服务数据单元 (MSDU) 数据包传送。

有关 StrictlyOrdered 服务类的详细信息,请参阅 IEEE 802.11-2012 标准的条款 5.1.3。

ucSupportedQoSProtocolFlags

一组标志,用于指定 NIC 实现的 QoS) 协议 (服务质量。 此成员为零或以下标志的按位 OR 组合:

DOT11_QOS_PROTOCOL_FLAG_WMM

NIC 实现 802.11 WMM QoS 协议。

DOT11_QOS_PROTOCOL_FLAG_11E

NIC 实现 802.11e QoS 协议。

bSafeModeImplemented

NIC/微型端口驱动程序组合的安全模式支持功能。 操作系统根据 Header.Revision 的值以不同的方式解释此成员:

Revision = DOT11_EXTSTA_ATTRIBUTES_REVISION_1

操作系统将 bSafeModeImplemented 成员解释为布尔值。 如果此值为 TRUE,则 NIC 实现 802.11 安全操作模式。 否则,该值为 FALSE

Revision = DOT11_EXTSTA_ATTRIBUTES_REVISION_2 或更高版本

操作系统将 bSafeModeImplemented 成员解释为设置了以下可能的位值的位字段:

  • 如果位字段设置为未设置其他位 的 DOT11_EXTSTA_ATTRIBUTES_SAFEMODE_OID_SUPPORTED ,则微型端口驱动程序将实现 802.11 安全操作模式。
  • 如果位字段设置为 DOT11_EXTSTA_ATTRIBUTES_SAFEMODE_CERTIFIED,则 NIC/微型端口组合已根据联邦信息处理标准 (FIPS) 出版物 140-2 加密 模块的安全要求收到了美国国家标准与技术研究院 (NIST) 的验证证书。
此成员与 OID_DOT11_SAFE_MODE_ENABLED

uNumSupportedCountryOrRegionStrings

802.11 工作站支持的国家或地区字符串数。 如果 802.11 工作站支持 IEEE 802.11d-2001 标准指定的多个法规域,则每个国家或地区字符串标识 802.11 工作站支持的监管域。

如果 802.11 工作站不支持 IEEE 802.11d-2001 标准,微型端口驱动程序必须将 uNumSupportedCountryOrRegionStrings 设置为零。

pSupportedCountryOrRegionStrings

指向 802.11 工作站支持的 802.11d 国家或地区字符串数组的指针。 数组中的每个条目都格式化为 DOT11_COUNTRY_OR_REGION_STRING 结构。

uInfraNumSupportedUcastAlgoPairs

802.11 工作站支持的用于发送和接收单播数据包的身份验证和密码算法的数量,该算法在基础结构基本服务集 (BSS) 网络中配置。 uInfraNumSupportedUcastAlgoPairs 成员必须是 pInfraSupportedUcastAlgoPairs 成员引用的数组中的DOT11_AUTH_CIPHER_PAIR结构数。

pInfraSupportedUcastAlgoPairs

指向 802.11 工作站支持的身份验证和密码算法数组的指针,用于在基础结构 BSS 网络中发送和接收单播数据包。 数组中的每个条目都格式化为 DOT11_AUTH_CIPHER_PAIR 结构。

uInfraNumSupportedMcastAlgoPairs

802.11 工作站支持的身份验证和密码算法的数量,用于发送和接收多播和广播数据包时,在基础结构基本服务集 (BSS) 网络。 uInfraNumSupportedMcastAlgoPairs 成员必须是 pInfraSupportedMcastAlgoPairs 成员引用的数组中的DOT11_AUTH_CIPHER_PAIR结构数。

pInfraSupportedMcastAlgoPairs

指向 802.11 工作站支持的身份验证和密码算法数组的指针,用于在基础结构 BSS 网络中发送和接收多播和广播数据包。 数组中的每个条目都格式化为 DOT11_AUTH_CIPHER_PAIR 结构。

uAdhocNumSupportedUcastAlgoPairs

配置为在独立的 BSS (IBSS) 网络中操作时,802.11 工作站支持的用于发送和接收单播数据包的身份验证和密码算法的数量。 uAdhocNumSupportedUcastAlgoPairs 成员必须是 pAdhocSupportedUcastAlgoPairs 成员引用的数组中DOT11_AUTH_CIPHER_PAIR结构的数目。

pAdhocSupportedUcastAlgoPairs

指向 802.11 工作站支持的身份验证和密码算法数组的指针,用于在 IBSS 网络中发送和接收单播数据包。 数组中的每个条目都格式化为 DOT11_AUTH_CIPHER_PAIR 结构。

uAdhocNumSupportedMcastAlgoPairs

配置为在 IBSS 网络中进行操作时,802.11 工作站支持的用于发送和接收多播和广播数据包的身份验证和密码算法的数量。 uAdhocNumSupportedMcastAlgoPairs 成员必须是 pAdhocSupportedMcastAlgoPairs 成员引用的数组中DOT11_AUTH_CIPHER_PAIR结构的数目。

pAdhocSupportedMcastAlgoPairs

指向 802.11 工作站支持的身份验证和密码算法数组的指针,用于在 IBSS 网络中发送和接收多播和广播数据包。 数组中的每个条目都格式化为 DOT11_AUTH_CIPHER_PAIR 结构。

bAutoPowerSaveMode

NIC/微型端口驱动程序组合的支持功能,用于自动管理电源,包括检测和协商设备与 Wi-Fi 接入点之间的正确 Wi-Fi 节电模式 (PSM) 。 符合 NDIS 6.30 Wi-Fi 微型端口驱动程序应将此成员设置为 TRUE。

uMaxNetworkOffloadListSize

如果微型端口驱动程序能够支持网络列表卸载功能,则可以卸载的最大网络数。

bMFPCapable

NIC/微型端口驱动程序的支持功能组合在 802.11w-2009 规范中指定的设备与 Wi-Fi 接入点之间支持管理帧保护。 如果支持,则设置为 TRUE。 否则,此成员应设置为 FALSE。

uInfraNumSupportedMcastMgmtAlgoPairs

pInfraSupportedMcastMgmtAlgoPairs 中指向的身份验证和密码算法对数组的长度。

pInfraSupportedMcastMgmtAlgoPairs

指向设备支持在基础结构模式下的 MFP 的身份验证和密码算法对数组的指针。 Windows 8的建议密码是使用 WPA 或 WPA2 身份验证的 BIP。 数组中的每个条目都格式化为 DOT11_AUTH_CIPHER_PAIR 结构。

bNeighborReportSupported

bAPChannelReportSupported

bActionFramesSupported

bANQPQueryOffloadSupported

bHESSIDConnectionSupported

注解

The NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES 结构包含一个成员 (pExtSTAAttributes) ,该成员指定DOT11_EXTSTA_ATTRIBUTES结构的地址。 当微型端口驱动程序调用 NdisMSetMiniportAttributes 时,驱动程序会将 MiniportAttributes 参数设置为驱动程序分配的内存块的地址,该块包含NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES结构以及DOT11_EXTSTA_ATTRIBUTES结构。

不支持对Windows 8强制实施管理帧保护 (MFPR) 。 因此,在关联请求期间,微型端口驱动程序不应在 RSN IE 的 RSN 功能中设置此位。 对于策略,接入点可能会播发 MFPR,这将允许支持 MFP 的 STA 进行关联。 不支持 MFP 功能的接入点将失败关联。 如果 MFPR 由接入点设置,并且 STA 不支持 MFP,Windows 8会将网络视为功能不匹配,并且不会向微型端口发送关联请求。

要求

要求
最低受支持的客户端 适用于 Windows 8 及更高版本的 Windows 操作系统。
标头 windot11.h (包括 Ndis.h)

另请参阅

可扩展工作站操作模式

OID_DOT11_DESIRED_BSSID_LIST

OID_DOT11_EXCLUDED_MAC_ADDRESS_LIST

OID_DOT11_PMKID_LIST

OID_DOT11_DESIRED_SSID_LIST

DOT11_COUNTRY_OR_REGION_STRING

OID_DOT11_SAFE_MODE_ENABLED

OID_DOT11_PRIVACY_EXEMPTION_LIST

NDIS_OBJECT_HEADER

OID_DOT11_CIPHER_KEY_MAPPING_KEY

DOT11_AUTH_CIPHER_PAIR

DOT11_CIPHER_ALGORITHM

每个工作站的默认密钥

NdisMSetMiniportAttributes

NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES

OID_DOT11_SCAN_REQUEST