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 連線能力,驅動程式必須將 NumSecondaryStaBandCombinations 和 SecondaryStaBandsCombinationsWIFI_STATION_CAPABILITIES 結構的字段設定為非零值。 如果任一值 0 或 NULL,則不會設定次要 Sta 功能。
若要指出 Wi-Fi 7 中 MLO 連線的支援,驅動程式必須將 MaxMLOLinksSupported、MLOAddressesList、NumAkmsSupported,以及 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 |