OID_WDI_SET_P2P_START_BACKGROUND_DISCOVERY
重要
このトピックは、Windows 10 でリリースされた WDI ドライバー モデルの一部です。 WDI ドライバー モデルはメンテナンス モードであり、優先度の高い修正プログラムのみを受け取ります。 WiFiCx は、Windows 11 でリリースされた Wi-Fi ドライバー モデルです。 最新機能を利用するには、WiFiCx を使用することをお勧めします。
OID_WDI_SET_P2P_START_BACKGROUND_DISCOVERY は、バックグラウンドで Wi-Fi ダイレクト検出を定期的に実行するようにアダプターに指示します
範囲 | タスクでシリアル化を設定する | 通常の実行時間 (秒) | データのスループット/待機時間に影響します |
---|---|---|---|
ポート | いいえ | 1 | はい |
アダプターは、一定の間隔で指定されたチャネルをスキャンし、デバイスの可視性タイムアウト (通常は 5 分) 内に検出可能になるデバイスを見つけることができるようにする必要があります。 この動作は、通常の Wi-Fi ダイレクト検出スキャン (OID_WDI_TASK_P2P_DISCOVERで定義) に似ていますが、時間制限はなく、アダプターは後の時点でスキャンをスケジュールする場合があります。 アダプターは、各デバイスの可視性タイムアウト内に少なくとも 1 つのスキャンを実行する必要があります。 デバイスの可視性タイムアウトが 0 の場合、アダプターは独自のサイクル時間を使用して定期的にスキャンを続行することになります。 この期間中に「検出」または「スキャン」タスク要求が行われた場合、アダプターはタスクの期間中バックグラウンド検出を中断し、タスクの完了後に続行することになります。 デバイスはバックグラウンド スキャンの完了時にNDIS_STATUS_WDI_INDICATION_P2P_DISCOVERY_COMPLETEの指示 (トランザクション ID が 0) を送信して、スキャンが完了したことをオペレーティング システムに通知する必要があります。 アダプターは、バックグラウンド スキャンが完了するたびにこの指示を送信する必要があります。
チャネル リストが指定されている場合、アダプターは指定されたチャネルでのみスキャンします。 それ以外の場合は、すべてのチャネルでスキャンします。 ファームウェアは、指定されたチャネルの外部でデバイスを検出した場合も、オペレーティング システムに情報を送信します。
リッスン期間とチャネル (WDI_TLV_P2P_DISCOVERY_CHANNEL_SETTINGS) を指定すると、リモート デバイスのリッスン時間を参照します。 アダプターは、リッスン期間とチャネルのすべての値を基に、最も効率的な方法で要求されたチャネルをスキャンするスケジュールを作成する必要があります。 オペレーティング システムで、リッスン期間とチャネルの複数のインスタンスを指定することもできます。 この場合、アダプターはまず、リッスン期間とチャネル リストの値が 0 以外のエントリのスキャン スケジュールを作成する必要があります。 次に、アダプターは次の場合に既定値を使用する必要があります:
- リッスン期間が 0 の場合、アダプターは、指定されたチャネルの既定のスキャン時間を使用します。
- チャネル リストが空の場合、アダプターは、そのバンドに対して指定されたリッスン時間とサイクル時間を使用して、そのバンド内のすべてのチャネルをスキャンします。 スキャン時間は、オペレーティング システムによって個別のリッスン期間を指定されたチャネルには適用されません。
NIC が D0 にある場合、アダプターは特定のサービス名に対するプローブ要求への応答を、オペレーティング システムへのNDIS_STATUS_WDI_INDICATION_BSS_ENTRY_LIST通知として示します。 WDI は上位レイヤー サービスの OS の応答情報をキャッシュし、必要に応じて通知します。
NIC が D2 にある場合、D0 に戻るまでバックグラウンド検出が中断されます。
プロパティのパラメーターの設定
TLV | 複数の TLV インスタンスを許可 | 省略可能 | 説明 |
---|---|---|---|
WDI_TLV_P2P_BACKGROUND_DISCOVER_MODE | Wi-Fi ダイレクト バックグラウンド検出モードのパラメーター。 | ||
WDI_TLV_P2P_DISCOVERY_CHANNEL_SETTINGS | x | x | スキャンする推奨チャネルの一覧。 |
WDI_TLV_P2P_DEVICE_FILTER_LIST | x | Wi-Fi ダイレクト デバイスの検出中に検索する Wi-Fi ダイレクト デバイスとグループ所有者の一覧。 | |
WDI_TLV_P2P_SERVICE_NAME_HASH | x | x | クエリを実行するサービス ハッシュ名の一覧。 これは、WDI_P2P_SERVICE_DISCOVERY_TYPE_SERVICE_NAME_ONLY が指定されている場合に必要です。 |
WDI_TLV_VENDOR_SPECIFIC_IE | x | ポートによって送信されるプローブ要求に含める必要がある 1 つ以上の IE。 |
プロパティの結果の設定
追加データはありません。 ヘッダー内のデータで十分です。
非応答型の指示
NDIS_STATUS_WDI_INDICATION_BSS_ENTRY_LIST
要件
サポートされている最小のクライアント |
Windows 10 |
サポートされている最小のサーバー |
Windows Server 2016 |
ヘッダー |
Dot11wdi.h |