OID_WDI_TASK_SCAN

重要

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

OID_WDI_TASK_SCAN请求对 BSS 网络进行调查。 端口根据 IEEE 802.11 规范的要求执行扫描。

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

端口启动扫描并准备好接收其他命令后，将指示包含 WDI_TLV_STATUS 的任务启动消息。

在 LiveUpdatesNeeded 启用扫描后，端口必须提供增量更新， (使用有关发现的 BSS 条目 的NDIS_STATUS_WDI_INDICATION_BSS_ENTRY_LIST) 的未经请求的指示。 端口不应报告以前已发现但当前扫描中的端口未找到的 BSS 条目。 出于电源和性能原因，端口应仅当主机发现 3 个或更多项，或者发现条目少于 3 个，但未向主机报告超过 500 毫秒时，端口应限制指示并将更新发送到主机。 扫描完成后，如果适配器不管理 BSS 条目，则无需记住已发现的 BSS 条目。 扫描操作完成后，端口必须向操作系统发送任务完成通知，并停止向主机报告 BSS 条目。 扫描命令用于查找旧版 (非Wi-Fi Direct网络) ，端口不应在探测请求中包含Wi-Fi直接 IE。

如果适配器不管理 BSS 条目，主机会在有限时间内记住端口从扫描报告的 BSS 条目。 它会超时缓存的条目并刷新它们。 如果适配器管理 BSS 条目，它会缓存并将它们超时。主机可能会发送 OID_WDI_SET_FLUSH_BSS_ENTRY 命令来显式刷新条目。

主机使用 BSSID 跟踪 BSS 条目。 如果端口报告同一 BSSID 的两个 BSS 条目，主机会用另一个覆盖一个。

在扫描过程中，端口必须维护现有连接 (例如基础结构或Wi-Fi Direct) 。 如果连接已存在，则端口应一次扫描一个通道子集，并在子集之间扫描通道，为媒体提供其他连接访问权限。 在扫描期间，主机可以将数据包发送请求提交到适配器上的任何端口。

在指示的 BSS 条目中，端口可以包含特定于设备的上下文信息。 如果要求端口连接到该 BSS 条目，则此上下文信息将传回设备。 但是，如果刷新 BSS 条目，主机可能会自动清除此上下文。

扫描命令可以中止。 收到中止命令后，端口应停止尝试查找新的 BSS 网络，并尽快完成扫描任务。 当任务正常 (或由于中止) 而完成时，端口应处于良好状态，以便可以在该端口上发出另一次扫描。

适配器在执行扫描时不得违反法规限制。

任务参数

TLV	允许多个 TLV 实例	可选	说明
WDI_TLV_BSSID			要扫描的网络的 BSSID。 如果这是广播 MAC 地址，则工作站会扫描所有 BSSSD。
WDI_TLV_SSID	X		端口应扫描的 SSID 列表的列表。 此列表中可以有多个 SSSD，其中一个可以是通配符。 在通道上执行活动扫描时，端口必须为列表中的每个 SSID 发送探测请求。 如果此列表为空，则端口必须扫描所有 SSD。
WDI_TLV_VENDOR_SPECIFIC_IE		X	必须包含在端口发送的探测请求中的一个或多个 IDE。 这些 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