DOT11_EXTSTA_ATTRIBUTES结构(windot11.h)
重要
WiFiCx 是 Windows 11 中发布的新 Wi-Fi 驱动程序模型。 建议使用 WiFiCx 来利用最新功能。 WDI 驱动程序模型现在处于维护模式,并且仅接收高优先级修补程序。
DOT11_EXTSTA_ATTRIBUTES 结构定义微型端口驱动程序的物理和作属性和 802.11 工作站在可扩展工作站(ExtSTA)模式下运行时。 有关此作模式的详细信息,请参阅 可扩展工作站作模式。
语法
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 结构。
微型端口驱动程序必须将 标头 的成员设置为以下值。
类型
此成员必须设置为 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 工作站支持的基本服务集标识符(BSSID)列表中的最大条目数。 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)开发的密码算法,表大小可以是四个或更大。
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 个每个工作站的默认密码密钥表。
有关每站默认密码密钥表的详细信息,请参阅 Per-Station 默认密钥。
bStrictlyOrderedServiceClassImplemented
一个布尔值,如果设置为 TRUE,则指定 802.11 工作站支持媒体访问控制(MAC)服务数据单元(MSDU)数据包传递的 IEEE 802.11 StrictlyOrdered 服务类。
有关 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。
修订版 = DOT11_EXTSTA_ATTRIBUTES_REVISION_2 或更高版本
作系统将 bSafeModeImplemented 成员解释为位字段,并设置了以下可能的位值:
- 如果位字段设置为 DOT11_EXTSTA_ATTRIBUTES_SAFEMODE_OID_SUPPORTED 且未设置其他位,则微型端口驱动程序将实现 802.11 安全作模式。
- 如果位字段设置为 DOT11_EXTSTA_ATTRIBUTES_SAFEMODE_CERTIFIED,NIC/微型端口组合已收到联邦信息处理标准(FIPS)出版物 140-2 下的美国国家标准与技术研究所(NIST)的验证证书,加密模块的安全要求。
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
在基础结构基本服务集(BSS)网络中配置作时,802.11 工作站支持发送和接收单播数据包的身份验证和密码算法数。 uInfraNumSupportedUcastAlgoPairs 成员必须是 pInfraSupportedUcastAlgoPairs 成员引用的数组中的 DOT11_AUTH_CIPHER_PAIR 结构数。
pInfraSupportedUcastAlgoPairs
指向 802.11 工作站支持的身份验证和密码算法数组的指针,用于在基础结构 BSS 网络中发送和接收单播数据包。 数组中的每个条目的格式设置为 DOT11_AUTH_CIPHER_PAIR 结构。
uInfraNumSupportedMcastAlgoPairs
在基础结构基本服务集(BSS)网络中配置作时,802.11 工作站支持的用于发送和接收多播和广播数据包的身份验证和密码算法数。 uInfraNumSupportedMcastAlgoPairs 成员必须是 pInfraSupportedMcastAlgoPairs 成员引用的数组中的 DOT11_AUTH_CIPHER_PAIR 结构数。
pInfraSupportedMcastAlgoPairs
指向 802.11 工作站支持的身份验证和密码算法数组的指针,用于在基础结构 BSS 网络中发送和接收多播和广播数据包。 数组中的每个条目的格式设置为 DOT11_AUTH_CIPHER_PAIR 结构。
uAdhocNumSupportedUcastAlgoPairs
802.11 工作站支持的身份验证和密码算法数,以便在为独立 BSS (IBSS) 网络中的作配置时发送和接收单播数据包。 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
言论
这 NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES 结构包含指定DOT11_EXTSTA_ATTRIBUTES结构的地址的成员(pExtSTAAttributes)。 当微型端口驱动程序调用 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) |