OID_WDI_TASK_DOT11_RESET

  • 项目

重要

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

OID_WDI_TASK_DOT11_RESET请求 IHV 组件重置指定端口上的 MAC 和 PHY 状态。

对象 支持中止 主机驱动程序策略) (默认优先级 正常执行时间 (秒)
端口 否 1 1

在发出 dot11 重置命令之前，WDI 驱动程序停止向 IHV 组件发出新命令，并中止端口上正在进行的任何任务。 它还会刷新其 Rx 和 TX 队列。

dot11 重置结合了 802.11 MLME 和 PLME 重置基元的语义。 当 IHV 组件收到 dot11 重置请求时，它应执行以下任务。

  • 将端口的 MAC 实体重置为其初始状态。
  • 重置端口的 MIB 属性，使其设置为其默认值（如果 bSetDefaultMIB 为 true）。
  • 重置 PHY 实体的 TX/Rx 状态机，并将其设置为仅 Rx 状态以确保不再传输帧。
  • 刷新适配器的 Rx 队列，并完成 TX 队列中每个数据包的发送。
  • 如果存在 MAC 地址参数，请将端口的 MAC 地址重置为指定的值。
  • 在完成 dot11 重置操作之前，将端口状态设置为 INIT。

如果正在重置的端口作为 STA、AP 或 Wi-Fi Direct Client 或 GO 运行，主机会触发断开连接任务，以请求 IHV 组件在重置之前向对等方发送取消关联。 因此，IHV 组件不需要再次执行此操作。

任务参数

TLV 允许多个 TLV 实例 可选 说明
WDI_TLV_DOT11_RESET_PARAMETERS dot11 重置的参数。
WDI_TLV_CONFIGURED_MAC_ADDRESS X 应用于端口的 MAC 地址。

任务完成指示

NDIS_STATUS_WDI_INDICATION_DOT11_RESET_COMPLETE

要求

最低受支持的客户端

Windows 10

最低受支持的服务器

Windows Server 2016

标头

 Dot11wdi.h