次の方法で共有


OID_WDI_TASK_CONNECT (dot11wificxintf.h)

重要

このトピックは、WiFiCx ドライバー モデルの一部です。 WiFiCx は、Windows 11 でリリースされた Wi-Fi ドライバー モデルです。 最新機能を利用するには、WiFiCx を使用することをお勧めします。 以前の Wi-Fi ドライバー モデル WDI はメンテナンス モードであり、優先度の高い修正プログラムのみを受け取ります。

OID_WDI_TASK_CONNECT は、IHV コンポーネントがアクセス ポイントまたは Wi-Fi Direct GO に接続するように要求します。

Object Abort 可能 既定の優先度 (ホスト ドライバー ポリシー) 通常の実行時間 (秒)
ポート はい。 abort 後に dot11 reset を実行する必要があります。 4 10

接続の一環として、IHV コンポーネントは BSS との同期、認証、および BSS への関連付けを行う必要があります。 ホストは、IHV コンポーネントが接続を試みることができる BSS エントリを提供します。 IHV コンポーネントがこれらのエントリのいずれかに正常に接続されたら、接続プロセスを完了する必要があります。 どの BSS エントリにも接続できない場合は、接続プロセスが失敗して完了します。

IHV コンポーネントでは、候補の BSS エントリを見つけるためにスキャンを実行する必要はありません。 接続には、ホストから提供されたリストを使用することができます。 1 つずつ順番に接続を試すことができます。 接続の際、ホストはネットワークを RSSI で並べ替えますが、IHV コンポーネントは独自の順序で並べ替えることができます。 アダプターが「Connect BSS Selection Override」を指定しない場合は、ホストが接続用に用意した項目のみを使用する必要があります。 ホストは、未処理の接続に対して abort を発行することができます。 abort を受信した場合、ポートは接続試行を終了し、完了をホストに報告します。

アダプターで「CONNECT BSS Selection Override」が指定されている場合、独自にスキャンを実行して、候補の BSS エントリを検索することができます。 ホストによって構成されたパラメーターに一致している場合、検出された BSS エントリに接続することができます。 この選択は、構成されている接続品質要件を確実に満たすように最適化する必要があります。 これには、ローミング スキャンの最適化、AP の選択の最適化、関連付けプロセスの最適化、必要なセキュリティ ハンドシェイクの最小化などが含まれます。 スキャン中に、デバイスで検出された BSS エントリに追加のアソシエートのパラメーター (ローミング用の PMKID など) が必要な場合、パラメーターを取得するためのNDIS_STATUS_WDI_INDICATION_ASSOCIATION_PARAMETERS_REQUESTの指示を送信することができます。 使用可能な場合、ホストはOID_WDI_SET_ASSOCIATION_PARAMETERSを使用してこれらのパラメーターを構成します。

接続が失敗した場合、または中止された場合、ポートは connect コマンド以外で設定された設定をリセットしないでください。 同一ポートから 2 つ目の connect コールを発行するホストをサポートする必要があります。

各 BSS エントリの接続試行の状態は、アソシエートの試行の最後にポートによって報告される必要があります。 これには、試行の成功と失敗も含まれます。 常に、ポートは複数のアクセス ポイントまたは Wi-Fi Direct GO にアソシエートされている必要があります。

接続が進行中は、ポートは他のポートで確立された接続を維持する必要があります (インフラストラクチャや Wi-Fi Direct など)。 ただし、ポートは、接続を終了するために他のポートに提供されるメディア アクセスの量を減らすことができます。 接続中に、ホストは他のポートからパケット送信要求を送信することができます。

接続に使用される認証アルゴリズムがネットワーク アクセスに 802.1x ポート承認を必要とする場合、ホストはアソシエート操作が正常に完了した後にポートを承認します。

802.11 ステーションは、堅牢なセキュリティ ネットワーク アソシエーション (RSNA) 認証アルゴリズムを有効にしたアクセス ポイントへの事前認証に PMKID キャッシュを使用します。 802.11 ステーションが PMKID が提供されている BSSID にアソシエートまたは再アソシエートする場合、802.11 ステーションは、アソシエーション フレームまたは再アソシエーション フレームの RSN 情報要素(RSN IE)で PMKID データを使用する必要があります。

ポートが WIFI_STATION_CAPABILITIES でホスト FIPS モードのサポートを宣言している場合は、接続パラメータで HostFIPSModeEnabled1 に設定できます。

HostFIPSModeEnabled1 に設定されている場合は、次の規則が適用されます。

  • ポートは、FIPS モードの送受信操作において、データ フレームの送受信に関するガイドラインに従う必要があります。
  • ポートは、HT 以外のアクセス ポイントに送信されるアソシエーション要求で QoS プロトコルのサポートを宣言してはなりません。 HT 接続には QoS のサポートが必要です。
  • ポートは TSpec をネゴシエートせず、送信 MSDU 集約を実行してはなりません。
  • ポートは、送信する RSN 機能 IE の SPP A-MSDU 対応ビット (ビット 10) がゼロに設定されていることを確認する必要があります。 このモードでは PP A-MSDU のみがサポートされています。

接続パラメータでは、MFPEnabledHostFIPSModeEnabled の両方を 1 に設定しないでください。 管理フレーム保護 (802.11w) では、ポートが特定の管理フレームとアクションフレームを暗号化/復号化する必要があるため、ホスト FIPS モードを使用した接続では有効にできません。 また、Wake on Wireless LAN の機能は、ホスト FIPS モードでは適用されません。

WiFi 7 / MLO の要件

Windows では、ドライバーが MLO を使用して接続できるかどうかを示す MloConnectionSupported 設定が、WDI_TLV_CONNECTION_SETTINGS に用意されています。 セキュア ネットワークに接続するとき、ドライバーは、WDI_TLV_RSNA_AKM_CIPHER_SUITE で指定された AKM と暗号ペアのみ使用できます。 唯一の例外は、認証/暗号が RSNA IE の一部ではない場合です。

詳しくは、「WiFiCx Wi-Fi 7 の機能要件」をご覧ください。

タスク パラメーター

TLV 複数の TLV インスタンスを許可 省略可能 説明
WDI_TLV_CONNECT_PARAMETERS 接続パラメーター
WDI_TLV_CONNECT_BSS_ENTRY x 候補接続 BSS エントリの優先リスト。 ポートは、リストが使い果たされるか、接続が正常に完了するまで、これらの BSS エントリのいずれかに接続を試みることになります。 ポートは、必要に応じてエントリの優先順位を再設定することができます。 アダプタが [BSS 選択オーバーライドの接続] ビットを設定している場合、許可/許可リストに従っている限り、このリストにない BSS を選択できます。

タスクの完了指示

NDIS_STATUS_WDI_INDICATION_CONNECT_COMPLETE

非応答型の指示

NDIS_STATUS_WDI_INDICATION_ASSOCIATION_RESULT

NDIS_STATUS_WDI_INDICATION_SAE_AUTH_PARAMS_NEEDED

要件

要件
サポートされている最小のクライアント Windows 11
サポートされている最小のサーバー Windows Server 2022
ヘッダー dot11wificxintf.h