次の方法で共有

OID_WDI_TASK_CONNECT (dot11wificxintf.h)

  • [アーティクル]

大事な

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

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

オブジェクト Abort 対応 既定の優先度 (ホスト ドライバー ポリシー) 通常の実行時間 (秒)
港 はい。 中止の後に dot11 リセットを実行する必要があります。 4 10

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

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

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

接続が失敗した場合、または中止された場合、ポートは connect コマンドの外部で構成されている可能性のある設定をリセットしないでください。 同じポートで 2 つ目の接続呼び出しを発行するホストをサポートする必要があります。

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

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

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

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

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

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

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

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

WiFi 7 / MLO の要件

Windows では、ドライバーが MLO を使用して接続できるかどうかを示す MloConnectionSupported 設定を WDI_TLV_CONNECTION_SETTINGS に します。 セキュリティで保護されたネットワークに接続する場合、ドライバーは AKM と WDI_TLV_RSNA_AKM_CIPHER_SUITEで指定された暗号ペアのみを使用できます。 唯一の例外は、認証/暗号が 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