传入操作帧唤醒

传入操作帧唤醒功能会在从 AP 接收特定操作帧时从低功耗状态唤醒 WiFiCx 设备。 WiFiCx 驱动程序必须支持传入操作帧唤醒,才能支持 QoS R1 功能,包括镜像流分类服务 (MSCS) 和 QoS 映射(DSCP 到 UP 映射)。

若要支持传入操作帧唤醒,驱动程序必须:

  1. WIFI_ADAPTER_WAKE_CAPABILITIES 中的 IncomingActionFrame 字段设置为 TRUE

  2. WIFI_STATION_CAPABILITIES 中的 MaxNumConfigurableActionFrameWakePatterns 字段设置为固件合理可配置的最大模式数。 如果驱动程序指示 IncomingActionFrame 支持,则此值必须为非零值。 如果 WIFI_ADAPTER_WAKE_CAPABILITIESIncomingActionFrame 字段为 true,驱动程序必须将 MaxNumConfigurableActionFrameWakePatterns 设置为:

    • 1,才能支持 MSCS。
    • 2,才能支持 QoS 映射。

如果 MaxNumConfigurableActionFrameWakePatterns 小于每个功能所需的最小值,则 OS 将禁用该功能。

MSCS、QoS 映射和需要传入操作帧唤醒的任何其他功能的唤醒模式要求数量将来可能会更改。

注意WifiPowerOffloadTypeWakeOnIncomingActionFrame 卸载的总数可能超过 MaxNumConfigurableActionFrameWakePatterns,因为在每个 NETADAPTER 上都可以卸载相同的唤醒模式。 例如,可以将 DSCP 到 UP 映射配置的传入操作帧唤醒卸载发送到主要和辅助 STA。 但是,卸载到设备的唯一模式总数将小于或等于 MaxNumConfigurableActionFrameWakePatterns

当设备位于 Dx 中并且收到与其中一个已卸载模式匹配的操作帧时,它必须唤醒,并且驱动程序必须使用 WifiAdapterReportWakeReason 函数报告 WifiWakeReasonTypeIncomingActionFrame,并指示收到的操作帧。