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 接続を維持する機能を示すには、ドライバーは、WIFI_STATION_CAPABILITIES構造体の NumSecondaryStaBandCombinations フィールドと SecondaryStaBandsCombinations フィールドを 0 以外の値に設定する必要があります。 値が 0 または NULL の場合、セカンダリ Sta 機能は設定されません。
Wi-Fi 7 での MLO 接続のサポートを示すために、ドライバーは、WIFI_STATION_CAPABILITIES構造体の MaxMLOLinksSupported、MLOAddressesList、NumAkmsSupported、および 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 |
| Header | wificx.h |
| IRQL | PASSIVE_LEVEL |