OID_WDI_TASK_CONNECT

重要

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

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 ステーションは、Association または Reassociation フレームの RSN 情報要素 (RSN IE) で PMKID データを使用する必要があります。

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

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

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

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

タスク パラメーター

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

タスクの完了指示

NDIS_STATUS_WDI_INDICATION_CONNECT_COMPLETE

非応答型の指示

NDIS_STATUS_WDI_INDICATION_ASSOCIATION_RESULT

NDIS_STATUS_WDI_INDICATION_SAE_AUTH_PARAMS_NEEDED

要件

サポートされている最小のクライアント	Windows 10
サポートされている最小のサーバー	Windows Server 2016
ヘッダー	Dot11wdi.h