OID_WDI_TASK_P2P_DISCOVER

重要

本主题是 Windows 10 中发布的 WDI 驱动程序模型的一部分。 WDI 驱动程序模型处于维护模式，仅会收到高优先级修补程序。 WiFiCx 是 Windows 11 中发布的Wi-Fi驱动程序模型。 建议使用 WiFiCx 来利用最新功能。

向设备发出OID_WDI_TASK_P2P_DISCOVER以执行Wi-Fi直接发现。

对象	支持中止	主机驱动程序策略) (默认优先级	正常执行时间 (秒)
端口	是的。 中止后，端口必须处于干净状态。	6	15

命令包含的属性定义一组特定的Wi-Fi Direct 设备进行搜索或通配符发现。

Wi-Fi直接发现与标准Wi-Fi扫描互斥。 运行此任务时，如果没有“DIRECT-”SSID 或特定的 GO SSID，则不得发送广播探测请求。 这些探测请求还必须包括所有必需的Wi-Fi直接 IDE。

主机可能具有未作为任务参数的一部分提供给设备的搜索条件。 如果主机符合所需条件，则可能会使用任务中止机制，因此设备必须能够快速中止Wi-Fi直接发现任务，以免降低方案性能。

当任务正常 (或由于中止) 而完成时，端口应处于良好状态，以便可以在该端口上发出另一个发现请求。

任务参数

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	端口应扫描的 SSD 列表。 此列表中可以有多个 SSD，其中一个 SSD 可以是通配符。 在通道上执行活动扫描时，端口必须为列表中的每个 SSID 发送探测请求。 如果此列表为空，则端口必须扫描所有 SSD。
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	必须包含在端口发送的探测请求中的一个或多个 IDE。 这些 IDE 不用于被动扫描。
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	在 Windows 10 版本 1607、WDI 版本 1.0.21 中添加。 要查询的 ASP2 服务信息发现条目的可选列表。 如果指定了WDI_P2P_SERVICE_DISCOVERY_TYPE_ASP2_SERVICE_INFORMATION，则这是必需的。 驱动程序应使用服务名称哈希通过探测请求/响应执行 P2P 服务发现。 对于包含服务信息的每个服务条目，驱动程序应执行 ANQP 查询请求/响应来查询服务信息。
WDI_TLV_P2P_INCLUDE_LISTEN_CHANNEL		X	在 Windows 10 版本 1607、WDI 版本 1.0.21 中添加。 指定探测请求在发现期间是否应包含侦听通道属性。

任务完成指示

NDIS_STATUS_WDI_INDICATION_P2P_DISCOVERY_COMPLETE

未经请求的指示

NDIS_STATUS_WDI_INDICATION_BSS_ENTRY_LIST

要求

最低受支持的客户端	Windows 10
最低受支持的服务器	Windows Server 2016
标头	Dot11wdi.h