windows网络适配器驱动开发-WPA3 SoftAP(三)

本文档为系列第三部分面向高负载及多频段共存场景详细阐述高性能模式下的优先策略、STA 漫游的决策树以及完整的错误代码返回规范。一、高性能 SoftAP 与 favorOverSta 标志针对增强现实AR、虚拟现实VR、无线投屏或实时游戏等对时延和带宽极其敏感的应用操作系统在启动 SoftAP 时会在 OID_WDI_TASK_START_AP 任务中置位 favorOverSta 标志。该标志向驱动程序明确传达了一个优先级信号当前 SoftAP 的链路质量优先级高于现有的 STA站点连接。驱动程序接收到此标志后被授权且被鼓励采取一系列主动优化措施包括但不限于主动选择干扰更少的频段或信道启动 SoftAP在必要时主动降低 STA 链路的发射功率或数据速率以腾出空口资源主动将 STA 连接漫游至其他频段如从 5 GHz 漫游至 2.4 GHz从而为 SoftAP 让出最佳信道。驱动还可以自主调整 Beacon 间隔、DTIM 周期等参数以优化吞吐量这些决策权完全下放给驱动开发者操作系统不做干预。二、针对频段/信道请求的漫游决策树操作系统在启动 SoftAP 时可能不指定频段/信道也可能明确指定。驱动程序针对这两种情况有着截然不同的处理策略情况 A操作系统未指定频段/信道驱动程序应综合考虑当前 STA 的工作频段、信道占用情况、噪声底噪以及可用信道列表自主选择最优的频段和信道启动 SoftAP。通常与 STA 相同的信道可以降低双并发切换开销但若该信道拥塞严重驱动也可另选其他空闲信道。任务必须成功完成。如果在 SoftAP 运行期间驱动程序发现通过移动 STA 至其他信道能进一步改善 SoftAP 性能则可通过 NDIS_STATUS_WDI_INDICATION_ROAMING_NEEDED 向操作系统发起漫游请求。漫游成功后驱动应将 SoftAP 无缝迁移至性能更优的新频段/信道。情况 B操作系统指定了具体频段或信道此时驱动需进行可行性评估若能在该指定频段/信道上维持合理性能则直接成功完成任务若当前 STA 占用了冲突的频段导致无法满足要求但存在可用的备用 BSS 供 STA 漫游且漫游后能在请求频段上正常维持 SoftAP同时漫游失败的概率较低则驱动程序应先行成功完成任务然后立即异步发送漫游请求以移动 STA。如果上述条件不满足例如无漫游候选、漫游极易失败则驱动程序必须使 OID_WDI_TASK_START_AP 任务失败并返回对应的错误码。三、运行期间的维护与失败处理驱动程序在成功完成启动任务后仍然可以随时发起漫游请求以维持或增强 SoftAP 性能。若漫游过程失败且当前已无法在不移动 STA 的情况下维持 SoftAP则驱动程序必须主动停止 SoftAP并通过 NDIS_STATUS_WDI_INDICATION_STOP_AP 通知操作系统原因码统一设为 WDI_STOP_AP_REASON_FREQUENCY_NOT_AVAILABLE。开发人员需特别注意避免“闪烁”现象——即 SoftAP 启动后因漫游失败而在数百毫秒内立即停止这会严重恶化用户体验。最佳实践是在完成 OID_WDI_TASK_START_AP 任务之前驱动程序应尽最大可能确认后续漫游的成功率例如预先扫描候选 BSS若预估成功率较低宁可直接返回失败也不要造成频繁的启动-停止震荡。四、错误代码规范速查表为了便于操作系统上层应用进行故障诊断驱动程序必须在各类异常场景中返回精确的错误码1. 若因国家或地区管制法规禁止使用特定频段或信道应返回 STATUS_NDIS_DOT11_AP_CHANNEL_NOT_ALLOWED 或 STATUS_NDIS_DOT11_AP_BAND_NOT_ALLOWED。2. 若因 STA 当前运行在冲突频段且无合理漫游候选导致无法启动应返回 STATUS_NDIS_DOT11_AP_CHANNEL_CURRENTLY_NOT_AVAILABLE 或 STATUS_NDIS_DOT11_AP_BAND_CURRENTLY_NOT_AVAILABLE。3. 若因硬件不支持指定的频段、信道组合或存在其他通用驱动问题应返回 STATUS_NOT_SUPPORTED 等通用错误。4. 在 SoftAP 运行中因漫游失败而被迫停止时统一使用停止原因码 WDI_STOP_AP_REASON_FREQUENCY_NOT_AVAILABLE。五、总结与建议综合三个文档所述完整的 WiFiCx WPA3 SoftAP 集成工作涉及能力声明、参数适配、SAE 精细化处理、高性能漫游决策以及严谨的错误上报五大模块。建议开发者在实现过程中优先保障防堵塞令牌的可选字段解析与组 19 的强制校验这两处是驱动稳定性最常见的隐患。其次在高性能模式下务必充分测试 STA 与 SoftAP 共存时的漫游切换确保切换过程中不掉线。最后严格遵守错误码映射规范这将极大提升用户端诊断问题的效率。以上即为 WiFiCx WPA3 SoftAP 的完整技术规格说明。