OID_WDI_TASK_P2P_DISCOVER (dot11wificxintf.h)

  • 项目

重要

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

向设备发出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 要查询的 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

要求

要求 值
最低受支持的客户端 Windows 11
最低受支持的服务器 Windows Server 2022
标头 dot11wificxintf.h