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 接続 維持する機能を示すには、ドライバーは、NumSecondaryStaBandCombinations と SecondaryStaBandsCombinations フィールドを WIFI_STATION_CAPABILITIES 0 以外の値に設定する必要があります。 いずれかの値が 0 または NULL 場合、セカンダリ Sta 機能は設定されません。
Wi-Fi 7 での MLO 接続のサポートを示すには、ドライバーは、MaxMLOLinksSupported、MLOAddressesList、NumAkmsSupported、および WIFI_STATION_CAPABILITIES 構造体の AkmsList フィールドを 0 以外の値に する必要があります。
GCMP-256 暗号で AKM 24 または AKM 8 を使用する SAE 接続をサポートするには、ドライバーは、WIFI_STATION_CAPABILITIES 構造に次の認証暗号ペアを追加する必要があります。
- ユニキャストAlgorithmsList: { DOT11_AUTH_ALGO_WPA3_SAE, DOT11_CIPHER_ALGO_GCMP_256 }
- MulticastMgmtAlgorithmsList: { DOT11_AUTH_ALGO_WPA3_SAE, DOT11_CIPHER_ALGO_GCMP_256 }
GCMP-256 暗号による OWE 接続をサポートするには、ドライバーで次の認証暗号ペアを追加する必要があります。
- ユニキャストAlgorithmsList: { DOT11_AUTH_ALGO_OWE, DOT11_CIPHER_ALGO_GCMP_256 }
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows 11 |
| サポートされる最小サーバー | Windows Server 2022 |
| ヘッダー | wificx.h |
| IRQL | PASSIVE_LEVEL |