企业官网建设流程全解析

本文档为系列第三部分，面向高负载及多频段共存场景，详细阐述高性能模式下的优先策略、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 的完整技术规格说明。