WifiDeviceSetStationCapabilities 函数 (wificx.h)
WifiDeviceSetStationCapabilities 函数设置 WiFiCx 设备的工作站功能。
语法
NTSTATUS WifiDeviceSetStationCapabilities(
WDFDEVICE Device,
const WIFI_STATION_CAPABILITIES *StationCapabilities
);
参数
Device
客户端驱动程序从上一次调用 WdfDeviceCreate 获取的框架设备对象的句柄。
StationCapabilities
指向客户端驱动程序分配和初始化 WIFI_STATION_CAPABILITIES 结构的指针。
返回值
如果操作成功，则返回STATUS_SUCCESS。 否则，此函数可能会返回相应的 NTSTATUS 错误代码。
注解
客户端驱动程序通常调用 EvtDevicePrepareHardware 中的 WifiDeviceSetStationCapabilities。 有关详细信息 ，请参阅默认 (工作站) 适配器创建流。
调用 WIFI_STATION_CAPABILITIES_INIT 以初始化 WIFI_STATION_CAPABILITIES 结构并填充其 Size 字段。 然后调用 WifiDeviceSetStationCapabilities 向 WiFiCx 报告工作站功能。
若要指示能够维护辅助 Sta 连接，驱动程序必须将WIFI_STATION_CAPABILITIES结构的 NumSecondaryStaBandCombinations 和 SecondaryStaBandsCombinations 字段设置为非零值。 如果任一值为 0 或 NULL，则不会设置辅助 Sta 功能。
若要指示对 Wi-Fi 7 中的 MLO 连接的支持，驱动程序必须将WIFI_STATION_CAPABILITIES结构的 MaxMLOLinksSupported、MLOAddressesList、NumAkmsSupported 和 AkmsList 字段设置为非零值。
若要支持将 AKM 24 或 AKM 8 与 GCMP-256 密码配合使用的 SAE 连接，驱动程序必须在 WIFI_STATION_CAPABILITIES 结构中添加以下身份验证-密码对：
- 在 UnicastAlgorithmsList 中： { DOT11_AUTH_ALGO_WPA3_SAE， DOT11_CIPHER_ALGO_GCMP_256 }
- 在 MulticastMgmtAlgorithmsList： { DOT11_AUTH_ALGO_WPA3_SAE， DOT11_CIPHER_ALGO_GCMP_256 }
若要使用 GCMP-256 密码支持 OWE 连接，驱动程序必须添加以下身份验证密码对：
- 在 UnicastAlgorithmsList 中： { DOT11_AUTH_ALGO_OWE， DOT11_CIPHER_ALGO_GCMP_256 }
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows 11 |
| 最低受支持的服务器 | Windows Server 2022 |
| 标头 | wificx.h |
| IRQL | PASSIVE_LEVEL |