OID_WDI_SET_NETWORK_LIST_OFFLOAD （dot11wificxintf.h）

2025-03-13

重要

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

OID_WDI_SET_NETWORK_LIST_OFFLOAD设置用于扫描 IP 的固件的首选 SSD 列表。

范围	使用任务设置序列化	正常执行时间（秒）
主端口	是的	1

有两种类型的网络列表卸载（NLO）。一种类型是卸载 Always On Always Connected （AOAC）系统上的 NIC。另一种是即时连接 NLO，在 Windows 8 和 Windows 8.1 中，仅用于非 AOAC 系统，以便在从休眠状态恢复时快速重新连接 Wi-Fi。

对于即时连接，列表在进入休眠状态之前发送。今后，即时连接用于从支持它的 AOAC 系统上的休眠状态恢复。

即时连接

WDI 处理即时连接 NLO，并使用目标扫描的组合来满足来自 OS 的请求。 IHV 驱动程序不需要处理此即时连接 OS 请求。

当 OS 从休眠状态恢复时，OS 会发送即时连接 NLO。 WDI 为目标扫描 OID 生成所有通道提示的联合。 IHV 驱动程序应支持 OID_WDI_TASK_SCAN中定义的此类目标扫描。以下部分适用于 AOAC 系统上支持 NIC 的网络列表卸载。

网络列表卸载

在 CS 中时，OS 不会请求定期后台扫描。 NLO 扫描是 CS 中的首选方法，因为当用户不需要查看所有可见的 IP 时，屏幕处于关闭状态。用户设置为自动连接配置文件的 SSID 是唯一有用的 IP。要从 OS 卸载的 SSID 列表具有首选的身份验证和密码对，以及最多四个通道提示。当列表至少有一个 SSID 时，固件应按照快速扫描和慢扫描阶段的计划开始自动执行 NLO 扫描。符合 WDI 的驱动程序将作系统请求转换为固件请求。固件应根据 IP 的计划执行 NLO 扫描。 IP 应支持与 SSD 关联的首选身份验证和密码对。

对固件的请求包含所有卸载 SSD 的通道提示列表。符合 WDI 的驱动程序将它们合并为固件。例如，如果 SSID1[auth1， cipher1] 的通道提示为 1 和 6，SSID2[auth2， cipher2] 的通道提示为 6 和 11，对固件的请求是 SSIDs { SSID1[auth1， auth1]、 SSID2[auth2， cipher2] } 和用于扫描 {1， 6， 11 }的通道列表。

在每个扫描期间，固件会扫描与通道列表上的条件匹配的 SSID，但不需要限制在通道列表上。应缓存发现的 AP 信息，以便主机进行检索。当至少有一个 BSSID 与 SSID、算法和密码匹配时，固件指示 NLO 发现，但不需要通道匹配。

UE 发送到 LE 的每个OID_WDI_SET_NETWORK_LIST_OFFLOAD都表示新的 NLO 扫描请求。任何以前的此类请求或状态都续订。 LE 扫描 NLO，仅指示每个请求找到的 AP 一次。如果找到的 AP 未成功连接（例如：发现 AP 但设备四处移动、AP 信号淡化且连接失败）;或者延长 EAP 身份验证失败，则 UE 在 Dx 转换时，NLO 会重新出现（12 次;否则，EAP 身份验证失败）。 LE 和固件应根据 WDI_TLV_NETWORK_LIST_OFFLOAD_CONFIG中的延迟配置延迟 NLO 扫描计划。这是 UE 用来符合作系统原始 NLO 命令的计划的数字。

NLO 的默认扫描类型为WDI_SCAN_TYPE_AUTO。当WDI_TLV_IS_DIRECTED_PROBE_FOR_HIDDEN_PERMITTED存在并且为 false 时，固件必须对活动扫描使用通配符 SSID 探测请求。当WDI_TLV_IS_DIRECTED_PROBE_FOR_HIDDEN_PERMITTED存在且为 true 时，允许定向探测请求（非通配符 SSID）。如果 TLV 不存在，固件应使用以前的行为。应将可见的 IP 与卸载列表中的 SSID 进行比较，以确定匹配项。此行为是保护用户隐私，同时仍保持在 NLO 扫描期间查找隐藏网络的能力。

指示 NLO 发现有两种情况。

当 NIC 处于 D2 中时，它必须执行以下步骤。
- 触发唤醒中断并等待将电源设置为 D0，然后继续执行以下步骤。
- 指示固件使用 NLO 发现的原因唤醒堆栈。
- 返回 D0 命令。
- 使用所有找到的 AP 信息指示 NLO 发现。
当 NIC 位于 D0 中时，它必须执行以下步骤。
- 使用所有找到的 AP 信息指示 NLO 发现。

设置属性参数

TLV	允许多个 TLV 实例	自选	描述
WDI_TLV_NETWORK_LIST_OFFLOAD_PARAMETERS			NLO 参数。

设置属性结果

无其他数据。标头中的数据已足够。

要求

要求	价值
支持的最低客户端	Windows 11
支持的最低服务器	Windows Server 2022
页眉	dot11wificxintf.h