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。