zx_system_set_processor_power_level_domain

摘要

将给定功率域内的处理器功率水平告知内核，以用于节能感知调度。

声明

#include <zircon/syscalls-next.h>

zx_status_t zx_system_set_processor_power_level_domain(
    zx_handle_t resource,
    uint64_t options,
    const zx_cpu_set_t* cpus,
    const zx_processor_power_level_t* power_levels,
    size_t num_power_levels,
    const zx_processor_power_level_transition_t* transitions,
    size_t num_transitions);

说明

为给定的处理器功率域启用能耗感知调度。

功率等级会隐式枚举为 power_levels 的索引。

transformations 没有排序限制，它们编码的功率级与 power_levels 定义的功率级相对应。系统会假定关卡之间不存在转换，表示使用性能不会产生任何能源成本。

权限

resource 的类型必须为 ZX_RSRC_KIND_SYSTEM 且基数为 ZX_RSRC_SYSTEM_CPU_BASE。

返回值

当且仅当处理器功率级域已成功注册时，才会返回 ZX_OK。

错误

如果 resource 不是有效的句柄，则返回 ZX_ERR_ACCESS_DENIED。

如果 resource 不是 SYSTEM 种类和 CPU 基础的有效资源句柄，则为 ZX_ERR_WRONG_TYPE。

如果 num_power_levels 超过 ZX_MAX_POWER_LEVELS 或 num_transitions 超过 ZX_MAX_POWER_LEVEL_TRANSITIONS，则为 ZX_ERR_OUT_OF_RANGE。