windot11.h) (DOT11_EXTSTA_ATTRIBUTES 结构
语法
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) 的验证证书。
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) |