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 }

要件

こちらもご覧ください

WIFI_STATION_CAPABILITIES

WIFI_STATION_CAPABILITIES_INIT

既定の (ステーション) アダプター作成フロー