OID_WDI_TASK_DOT11_RESET (dot11wificxintf.h)
重要
本主题是 WiFiCx 驱动程序模型的一部分。 WiFiCx 是在 Windows 11 中发布的 Wi-Fi 驱动程序模型。 我们建议您使用 WiFiCx 来利用最新功能。 以前的 Wi-Fi 驱动程序模型 WDI 处于维护模式,仅接收高优先级修复。
OID_WDI_TASK_DOT11_RESET 请求 IHV 组件在指定端口上重置 MAC 和 PHY 状态。
Object | 支持中止 | 默认优先级(主机驱动程序策略) | 正常执行时间(秒) |
---|---|---|---|
端口 | 否 | 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 客户端或 GO 运行,则主机会触发断开连接任务,以请求 IHV 组件在重置之前向对等方发送解除关联。 因此,IHV 组件不需要再次执行此操作。
任务参数
TLV | 允许多个 TLV 实例 | 可选 | 说明 |
---|---|---|---|
WDI_TLV_DOT11_RESET_PARAMETERS | dot11 重置参数。 | ||
WDI_TLV_CONFIGURED_MAC_ADDRESS | X | 应用于端口的 MAC 地址。 | |
WDI_TLV_CONFIGURED_MLO_LINK_MAC_ADDRESS | X | 多链接操作 (MLO) 链路 MAC 地址的数组。 |
任务完成指示
NDIS_STATUS_WDI_INDICATION_DOT11_RESET_COMPLETE
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 11 |
最低受支持的服务器 | Windows Server 2022 |
头文件 | dot11wificxintf.h |
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈