WIFI_STATION_CAPABILITIES 结构 (wificx.h)
WIFI_STATION_CAPABILITIES结构描述了 WiFiCx 设备的工作站功能。
语法
typedef struct _WIFI_STATION_CAPABILITIES {
ULONG Size;
UINT32 ScanSSIDListSize;
UINT32 DesiredSSIDListSize;
UINT32 PrivacyExemptionListSize;
UINT32 KeyMappingTableSize;
UINT32 DefaultKeyTableSize;
UINT32 WEPKeyValueMaxLength;
UINT32 MaxNumPerSTA;
UINT8 SupportedQOSFlags;
UINT8 HostFIPSModeImplemented;
UINT8 MFPCapable;
BOOLEAN AutoPowerSaveMode;
BOOLEAN BSSListCachemanagement;
BOOLEAN ConnectBSSSelectionOverride;
UINT32 MaxNetworkOffloadListSize;
BOOLEAN HESSIDConnectionSupported;
BOOLEAN FTMAsInitiatorSupport;
UINT32 FTMNumberOfSupportedTargets;
BOOLEAN HostWPA3FIPSModeEnabled_Deprecated;
ULONG NumSupportedUnicastAlgorithms;
PDOT11_AUTH_CIPHER_PAIR UnicastAlgorithmsList;
ULONG NumSupportedMulticastDataAlgorithms;
PDOT11_AUTH_CIPHER_PAIR MulticastDataAlgorithmsList;
ULONG NumSupportedMulticastMgmtAlgorithms;
PDOT11_AUTH_CIPHER_PAIR MulticastMgmtAlgorithmsList;
ULONG NumSecondaryStaBandCombinations;
WIFI_STA_BANDS_COMBINATION *SecondaryStaBandsCombinations;
ULONG MaxMLOLinksSupported;
BOOLEAN DoNotUseOsReserved;
WDI_MAC_ADDRESS *MLOAddressesList;
ULONG NumAkmsSupported;
RSNA_AKM_SUITE *AkmsList;
ULONG NumFIPSCertifiedCipherAlgorithms;
WDI_CIPHER_ALGORITHM *FIPSCertifiedCipherAlgorithmsList;
BOOLEAN MSCSSupported;
BOOLEAN DSCPToUPMappingSupported;
UINT32 MaxNumConfigurableActionFrameWakePatterns;
BOOLEAN CrossAkmCipherRoamSupported;
} WIFI_STATION_CAPABILITIES;
成员
Size
所有包含元素大小) 的总 (字节数。
ScanSSIDListSize
扫描 SSID 列表大小。
DesiredSSIDListSize
所需的 SSID 列表大小。
PrivacyExemptionListSize
隐私豁免列表大小。
KeyMappingTableSize
键映射表大小。
DefaultKeyTableSize
默认键表大小。
WEPKeyValueMaxLength
WEP 键值的最大长度。
MaxNumPerSTA
每个 STA 默认键表的最大数目。
SupportedQOSFlags
指定是否支持 WMM QOS。 有效值为 0 (不支持) 和 1 (支持的) 。
HostFIPSModeImplemented
指定是否支持主机 FIPS 模式。 有效值为 0 (不支持) 和 1 (支持的) 。
MFPCapable
指定是否支持管理帧保护 (MFP) 。 有效值为 0 (不支持) 和 1 (支持的) 。
AutoPowerSaveMode
指定是否支持自动省电。 有效值为 0 (不支持) 和 1 (支持的) 。
BSSListCachemanagement
指定适配器是否将维护工作站 BSS 列表缓存。 有效值为 0 (no) 和 1 (yes) 。
ConnectBSSSelectionOverride
指定是否在工作站上连接适配器可能会尝试关联到未在首选 BSSID 列表中指定的 BSSID。 有效值为 0 (no) 和 1 (yes) 。
MaxNetworkOffloadListSize
指定支持的网络卸载条目数。
HESSIDConnectionSupported
指定是否支持连接到 HESSID 的功能。 有效值为 0 (不支持) 和 1 (支持的) 。
FTMAsInitiatorSupport
指定是否支持作为发起程序的 FTM 过程。 有效值为 0 (不支持) 和 1 (支持的) 。
FTMNumberOfSupportedTargets
每个 FTM 请求任务支持的目标 STA 数。
HostWPA3FIPSModeEnabled_Deprecated
NumSupportedUnicastAlgorithms
支持的单播算法数。
UnicastAlgorithmsList
指向格式化为DOT11_AUTH_CIPHER_PAIR结构的单播密码算法数组 的 指针。 此数组的长度由 NumSupportedUnicastAlgorithms 成员指定。
NumSupportedMulticastDataAlgorithms
支持的多播数据密码算法的数量。
MulticastDataAlgorithmsList
指向格式化为DOT11_AUTH_CIPHER_PAIR结构的多播数据密码算法数组 的 指针。 此数组的长度由 NumSupportedMulticastDataAlgorithms 成员指定。
NumSupportedMulticastMgmtAlgorithms
支持的多播管理算法数。
MulticastMgmtAlgorithmsList
指向格式化为DOT11_AUTH_CIPHER_PAIR结构的多播管理算法数组 的 指针。 此数组的长度由 NumSupportedMulticastMgmtAlgorithms 成员指定。
NumSecondaryStaBandCombinations
辅助 STA 波段组合的数目。 如果此值为 0，则不会设置辅助 STA 功能。
SecondaryStaBandsCombinations
指向WIFI_STA_BANDS_COMBINATION结构的数组 的 指针。 如果此值为 NULL，则不会设置辅助 STA 功能。
MaxMLOLinksSupported
硬件支持多链路操作的最大链接数 (MLO) 连接。
DoNotUseOsReserved
MLOAddressesList
指向 WDI_MAC_ADDRESS 结构的数组的指针，这些结构表示具有 MaxMLOLinksSupported 元素的 MLO MAC 地址。 MLOAddressesList 中的条目数必须与 MaxMLOLinksSupported 匹配。 这将指示驱动程序能够设置 MLO 链接。
NumAkmsSupported
驱动程序支持的 AKM) 套件 (身份验证和密钥管理的最大数量。
AkmsList
指向表示 AKM 套件 的RSNA_AKM_SUITE 结构的数组的指针，其中包含 NumAkmsSupported 元素。 此列表应包括驱动程序支持的所有 AKM 套件，并且如果 OS 预期支持同时对具有 384 位成对主密钥 ( (PMK) 的 SAE) 进行 Equals 身份验证，则此列表应包括 AKM 24。 MLOAddressesList 中的条目数必须与 NumAkmsSupported 匹配。
NumFIPSCertifiedCipherAlgorithms
设备已获得 FIPS 140 认证的密码算法数。
FIPSCertifiedCipherAlgorithmsList
指向设备已获得 FIPS 140 认证的 DOT11_CIPHER_ALGORITHM 结构数组的指针，其中包含 NumFIPSCertifiedCipherAlgorithms 元素。
MSCSSupported
一个 BOOLEAN，指示驱动程序是否支持镜像Stream分类服务 (MSCS) 。
DSCPToUPMappingSupported
一个 BOOLEAN，指示驱动程序是否支持 QoS 映射 (区分服务代码点 (DSCP) 到用户优先级 (UP) 映射) 。
MaxNumConfigurableActionFrameWakePatterns
设备支持的最大操作帧唤醒模式数。 驱动程序必须将 MaxNumConfigurableActionFrameWakePatterns 至少设置为：
- 1 支持 MSCS。
- 2 ，支持 DSCP 到 UP 映射。
如果 MaxNumConfigurableActionFrameWakePatterns 小于每个功能所需的最小值，则 OS 将禁用该功能。
CrossAkmCipherRoamSupported
注解
调用 WIFI_STATION_CAPABILITIES_INIT 初始化此结构并填充其 Size 字段。 然后调用 WifiDeviceSetStationCapabilities 向 WiFiCx 报告工作站功能。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows 11 |
| 最低受支持的服务器 | Windows Server 2022 |
| 标头 | wificx.h |