DOT11_OFFLOAD_NETWORK_LIST_INFO结构(windot11.h)

重要

WiFiCx 是 Windows 11 中发布的新 Wi-Fi 驱动程序模型。 建议使用 WiFiCx 来利用最新功能。 WDI 驱动程序模型现在处于维护模式,并且仅接收高优先级修补程序。

DOT11_OFFLOAD_NETWORK_LIST_INFO结构描述网络卸载列表 (NLO)。

语法

typedef struct _DOT11_OFFLOAD_NETWORK_LIST_INFO {
  NDIS_OBJECT_HEADER    Header;
  ULONG                 ulFlags;
  ULONG                 FastScanPeriod;
  ULONG                 FastScanIterations;
  ULONG                 SlowScanPeriod;
  ULONG                 uNumOfEntries;
  DOT11_OFFLOAD_NETWORK offloadNetworkList[1];
} DOT11_OFFLOAD_NETWORK_LIST_INFO, *PDOT11_OFFLOAD_NETWORK_LIST_INFO;

成员

Header

DOT11_OFFLOAD_NETWORK_LIST_INFO结构的类型、修订和大小。 标头 的成员所需的设置如下。

成员 设置
类型 NDIS_OBJECT_TYPE_DEFAULT
修订 DOT11_OFFLOAD_NETWORK_LIST_REVISION_1
大小 DOT11_SIZEOF_OFFLOAD_NETWORK_LIST_INFO_REVISION_1

ulFlags

用于从下表中指定此 NLO 的额外属性的位标志:

价值 意义
DOT11_NLO_FLAG_STOP_NLO_INDICATION 指定应立即停止 NLO 扫描。 不应再进行 NLO 扫描。 也不应指示 NLO 发现。 uNumOfEntries 应为 0。
DOT11_NLO_FLAG_SCAN_ON_AOAC_PLATFORM 指定 NLO 应立即扫描,并遵循快速扫描和慢扫描的计划。 这通常用于 Always-On-Always-Connected (AOAC) 平台。 uNumOfEntries 可以是 0 到 n
DOT11_NLO_FLAG_SCAN_AT_SYSTEM_RESUME 指定 NLO 在非 AOAC 平台上的系统恢复中使用,这绝不是 AOAC 平台的情况。 系统挂起时,可能会事先发送 NLO OID。 微型端口/硬件不应立即启动 NLO 扫描。 列表应保留在微型端口驱动程序或硬件中。 系统恢复时,微型端口/硬件应尝试连接到以前的已连接网络。 在工作失败或之前没有连接 AP 时,应立即扫描该列表。

FastScanPeriod

快速扫描周期(以秒为单位)。 当 NIC 收到卸载列表时,它应扫描 FastScanPeriod 间隔内列表的匹配项。 在快速扫描期间,NIC 会扫描每个此类期间 FastScanIteration 有趣的 SSID,然后切换到 SlowScanPeriod

FastScanIterations

如果迭代重复快速扫描,则为数字。 达到迭代次数时,NIC 会切换到 SlowScanPeriod

SlowScanPeriod

扫描周期缓慢,以秒为单位。 FastScanPeriod 过期后,NIC 切换到 SlowScanPeriod。 NIC 应扫描 SlowScanPeriod中的列表的匹配项。 持续时间已结束,直到 Windows 发出更新的卸载列表。

uNumOfEntries

请求卸载的网络列表中的网络数。

offloadNetworkList[1]

硬件应自动搜索的网络数组。

要求

要求 价值
最低支持的客户端 Windows 8 中的版本:_Supported
标头 windot11.h (包括 Windot11.h)