Share via

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

另请参阅

WIFI_STATION_CAPABILITIES

WIFI_STATION_CAPABILITIES_INIT

默认 (工作站) 适配器创建流