通过

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 结构，并填写其 大小 字段。 然后调用 WifiDeviceSetStationCapabilities 向 WiFiCx 报告工作站功能。

若要指示能够维护 辅助 Sta 连接，驱动程序必须将 NumSecondaryStaBandCombinations 和 SecondaryStaBandsCombinationsWIFI_STATION_CAPABILITIES 结构的字段设置为非零值。 如果任一值 0 或 NULL，则不会设置辅助 Sta 功能。

若要指示对 Wi-Fi 7 中的 MLO 连接的支持，驱动程序必须将 MaxMLOLinksSupported、MLOAddressesList、NumAkmsSupported，并将 WIFI_STATION_CAPABILITIES 结构的 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

默认（工作站）适配器创建流