次の方法で共有

OID_WDI_TASK_SCAN

  • [アーティクル]

重要

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

OID_WDI_TASK_SCAN は、BSS ネットワークの調査を要求します。 ポートは、IEEE 802.11 仕様の要件に従ってスキャンを実行します。

Object Abort 可能 既定の優先度 (ホスト ドライバー ポリシー) 通常の実行時間 (秒)
ポート はい。 中止後、ポートはクリーン状態である必要があります。

6 (バックグラウンド・スキャン)

5 (ユーザーが開始したスキャン)

 4

ポートがスキャンを開始し、他のコマンドを受信できる状態になると、WDI_TLV_STATUSを含むタスク開始メッセージが示されます。

LiveUpdatesNeeded によって有効にされたときにスキャンが開始されると、ポートは検出された BSS エントリに関する増分更新 (NDIS_STATUS_WDI_INDICATION_BSS_ENTRY_LISTの非応答型の指示を使用) を提供する必要があります。 以前に検出されたが、現在のスキャンのポートで検出されなかった BSS エントリは、ポートによって報告されません。 電力とパフォーマンス上の理由から、ポートは、3 つ以上のエントリを検出し場合、または 3 つ未満の 500 ミリ秒を超えてホストに報告していない場合にのみ、指示を調整してホストに更新を送信する必要があります。 アダプターが BSS エントリを管理していない場合、スキャン完了後に、検出された BSS エントリを記憶する必要はありません。 スキャン操作完了後、ポートはタスク完了通知をオペレーティング システムに送信し、BSS エントリのホストへの報告を停止する必要があります。 scan コマンドはレガシー (非 Wi-Fi Direct ネットワーク) の検索に使用され、ポートにはプローブ要求に Wi-Fi Direct IE を含めないようにする必要があります。

アダプターが BSS エントリを管理しない場合、ホストは、スキャンによってポートから報告された BSS エントリを一定期間記憶します。 キャッシュされたエントリはタイムアウトすると、フラッシュされます。 アダプターが BSS エントリを管理する場合、アダプターがキャッシュとタイムアウトを行います。ホストは、OID_WDI_SET_FLUSH_BSS_ENTRYコマンドを送信することで、エントリを明示的にフラッシュすることができます。

ホストは、BSSID を使用して BSS エントリを追跡します。 ポートが同じ BSSID に対して 2 つの BSS エントリを報告した場合、ホストは 1 つをもう一方の BSSID で上書きします。

スキャン進行中は、ポートは既存の接続 (インフラストラクチャや Wi-Fi Direct など) を維持する必要があります。 接続が既に存在する場合、ポートは一度にチャネルのサブセットをスキャンし、その間、他の接続にメディアへのアクセスを提供する必要があります。 スキャン中、ホストはアダプター上の任意のポートにパケット送信要求を送信することができます。

示された BSS エントリで、ポートはデバイス固有のコンテキスト情報を含めることができます。 ポートがその BSS エントリに接続するように求められた場合、このコンテキスト情報はデバイスに戻されます。 ただし、BSS エントリがフラッシュされた場合、このコンテキストはホストによって自動的にクリアされる可能性があります。

scan コマンドは強制終了することができます。 abort コマンドを受信した場合、ポートは新しい BSS ネットワークの検索の試行を停止し、できるだけ早くスキャン タスクを完了する必要があります。 タスクの完了後 (通常完了でも abort でも) は、そのポートで別のスキャンを発行できるよう、ポートが適切な状態になっている必要があります。

スキャン実行時、アダプターは規制の制約に違反してはなりません。

タスク パラメーター

TLV 複数の TLV インスタンスを許可 省略可能 説明
WDI_TLV_BSSID スキャンするネットワークの BSSID。 これがブロードキャスト MAC アドレスの場合、ステーションはすべての BSSID をスキャンします。
WDI_TLV_SSID x ポートがスキャンする必要がある SSID リストの一覧。 このリストには複数の SSID を含めることができ、そのうちの 1 つをワイルドカードにすることができます。 チャネルでアクティブ スキャンを実行する場合、ポートはリスト内の各 SSID に対してプローブ要求を送信する必要があります。 このリストが空の場合、ポートはすべての SSID をスキャンする必要があります。
WDI_TLV_VENDOR_SPECIFIC_IE x ポートによって送信されるプローブ要求に含める必要がある 1 つ以上の IE。 これらの IE はパッシブ スキャンには使用されません。
WDI_TLV_SCAN_MODE スキャン モードのパラメーター。
WDI_TLV_SCAN_DWELL_TIME 滞在時間パラメーター。
WDI_TLV_BAND_CHANNEL x x スキャンする推奨チャネルの一覧。 アダプターは、スキャン時間要件内であれば、チャネル リストのサブセットまたはスーパーセットでスキャンを実行することができます。 リストが空の場合、ポートはサポートされているすべてのチャネルでスキャンする必要があります。

タスクの完了指示

NDIS_STATUS_WDI_INDICATION_SCAN_COMPLETE

非応答型の指示

NDIS_STATUS_WDI_INDICATION_BSS_ENTRY_LIST

この通知は、BSS エントリの更新についてホストに通知するためにデバイスによって使用されます。 いつでも送信できます。

要件

サポートされている最小のクライアント

Windows 10

サポートされている最小のサーバー

Windows Server 2016

ヘッダー

 Dot11wdi.h