共用方式為


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。 如需詳細資訊,請參閱 Default (station) 配接器建立流程。

呼叫 WIFI_STATION_CAPABILITIES_INIT 以初始化 WIFI_STATION_CAPABILITIES 結構,並填入其 Size 字段。 然後呼叫 WifiDeviceSetStationCapabilities 向 WiFiCx 報告月臺功能。

若要指出 次要 Sta 連線能力,驅動程式必須將 NumSecondaryStaBandCombinationsSecondaryStaBandsCombinationsWIFI_STATION_CAPABILITIES 結構的字段設定為非零值。 如果任一值 0NULL,則不會設定次要 Sta 功能。

若要指出 Wi-Fi 7 中 MLO 連線的支援,驅動程式必須將 MaxMLOLinksSupportedMLOAddressesListNumAkmsSupported,以及 AkmsListWIFI_STATION_CAPABILITIES 結構的字段設定為非零值。

若要支援使用 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

預設(站)配接器建立流程