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 連線能力，驅動程式必須將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 加密的連線，驅動程式必須新增下列驗證加密組：
- 在 UnicastAlgorithmsList： { DOT11_AUTH_ALGO_OWE， DOT11_CIPHER_ALGO_GCMP_256 }
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 11 |
| 最低支援的伺服器 | Windows Server 2022 |
| 標頭 | wificx.h |
| IRQL | PASSIVE_LEVEL |