OID_WDI_TASK_P2P_DISCOVER (dot11wificxintf.h)

  • [アーティクル]

重要

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

Wi-Fi Direct 検出を実行するための OID_WDI_TASK_P2P_DISCOVER がデバイスに発行されます。

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

このコマンドには、検索する Wi-Fi Direct デバイスの特定のセット、またはワイルドカード検出を定義するプロパティが含まれています。

Wi-Fi Direct 検出は、標準の Wi-Fi スキャンとは相互に排他的です。 このタスクの実行中は、「DIRECT-」SSID または特定の GO SSID なしでブロードキャストプローブ要求を送信してはなりません。 これらのプローブ要求には、必要なすべての Wi-Fi Direct IE も含まれている必要があります。

ホストには、デバイスまでのタスク パラメーターの一部として提供されていない検索条件がある場合があります。 ホストは、必要な条件に一致した場合に、タスク中止メカニズムを使用でき、シナリオのパフォーマンスを低下させないように Wi-Fi Direct Discovery タスクをデバイスが 迅速に中止できることが重要です。

タスクが (正常に、または中止によって) 完了すると、ポートはそのポートで別の検出要求を発行できるような良好な状態になります。

タスク パラメーター

TLV 複数の TLV インスタンスを許可 省略可能 説明
WDI_TLV_P2P_DISCOVER_MODE 検出モード情報 (スキャンの種類、回数、スキャン間の時間など)。
WDI_TLV_SCAN_DWELL_TIME スキャン滞留時間の設定。
WDI_TLV_P2P_DISCOVERY_CHANNEL_SETTINGS x x スキャン期間とスキャンするチャンネルのリスト。 リッスン設定を指定すると、リッスン設定は WDI_TLV_SCAN_DWELL_TIME で指定された設定よりも優先されます。 このリストが空の場合、ポートはサポートされているすべてのチャネルでスキャンし、WDI_TLV_SCAN_DWELL_TIME のリッスン設定を使用する必要があります。
WDI_TLV_SSID x x ポートがスキャンする SSID のリスト。 このリストには複数の SSID を含めることができ、そのうちの 1 つをワイルドカードにすることができます。 チャネルでアクティブ スキャンを実行する場合、ポートは、リスト内の各 SSID に対してプローブ要求を送信する必要があります。 このリストが空のとき、ポートはすべての SSID をスキャンする必要があります。
WDI_TLV_P2P_SERVICE_NAME_HASH x x 照会するサービス・ハッシュ名のリスト。 WDI_P2P_SERVICE_DISCOVERY_TYPE_SERVICE_NAME_ONLY または WDI_P2P_SERVICE_DISCOVERY_TYPE_ASP2_SERVICE_NAME_ONLY が指定されている場合は必須です。
WDI_TLV_VENDOR_SPECIFIC_IE x ポートから送信されるプローブ要求に含めることが必要な 1 つ以上の IE。 これらの IE はパッシブ スキャンには使用されません。
WDI_TLV_P2P_SERVICE_INFORMATION_DISCOVERY_ENTRY x x 照会するサービス情報検出エントリのオプションのリスト。 これは、WDI_P2P_SERVICE_DISCOVERY_TYPE_SERVICE_INFORMATION が指定されている場合に必要です。 ドライバーは、サービス名ハッシュを使用して、プローブ要求/応答に対して P2P サービス検出を実行することが期待されます。 サービス情報を含むサービス エントリごとに、ドライバーは、ANQP クエリ要求/応答を実行して、サービス情報を照会する必要があります。
WDI_TLV_P2P_ASP2_SERVICE_INFORMATION_DISCOVERY_ENTRY x x 照会する ASP2 サービス情報検出エントリのオプションのリスト。 これは、WDI_P2P_SERVICE_DISCOVERY_TYPE_ASP2_SERVICE_INFORMATIONが指定されている場合に必要です。 ドライバーは、サービス名ハッシュを使用して、プローブ要求/応答に対して P2P サービス検出を実行することが期待されます。 サービス情報を含むサービス エントリごとに、ドライバーは、ANQP クエリ要求/応答を実行して、サービス情報を照会する必要があります。
WDI_TLV_P2P_INCLUDE_LISTEN_CHANNEL x ディスカバリー時にプローブ要求に「リッスン・チャネル」属性を含めるかどうかを指定します。

タスク完了表示

NDIS_STATUS_WDI_INDICATION_P2P_DISCOVERY_COMPLETE

未承諾の指示

NDIS_STATUS_WDI_INDICATION_BSS_ENTRY_LIST

要件

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