zx_system_create_processor_power_level_transition_handler

摘要

為核心提供通訊埠的控制代碼，讓排程器可要求存取該通訊埠 電源層級轉換；由控制介面組成。

也就是說，系統會針對指定介面提供指定的控制項引數 讓處理常式能夠根據電量資訊執行轉場效果 提供給核心使用

宣告

#include <zircon/syscalls-next.h>

zx_status_t zx_system_create_processor_power_level_transition_handler(
    zx_handle_t resource,
    uint32_t options,
    zx_processor_power_control_t control,
    zx_handle_t* out_port);

說明

為核心提供機制，啟用節能排程功能 ，用於要求 OPP 轉場效果。接上通訊埠並執行通訊 啟動核心後，核心會排入ZX_PKT_TYPE_OPP_TRANSITION個別電源 網域轉換在任何時間點，佇列中的轉換不會超過 。

作業的另一半，確認此作業已開始進行 透過 zx_system_set_performance_info 以 ZX_POWER_DOMAIN_OPP_TRANSITION 做為主題 詳情請參閱 zx_system_set_performance_info 說明文件。

如果建立的通訊埠控點 out_port 已關閉，核心會在沒有的情況下運作 可移動 OPP，也就是關閉控點，即「卸除」 通訊埠。

resource 必須是 ZX_RSRC_KIND_SYSTEM 種類，且 基礎為 ZX_RSRC_SYSTEM_CPU_BASE。

options 必須為 0。

control 會指定這個處理常式服務的電源等級控制介面。 必須為 PROCESSOR_POWER_CONTROL_CPU_DRIVER。

out_port 必須設定有效的指標。成功時

權限

resource 至少必須擁有下列權限：

  • ZX_RIGHT_WRITE

傳回值

成功後，ZX_OK 會傳回，out_port 會指向新的控制代碼， 下列權利：

  • ZX_RIGHT_TRANSFER
  • ZX_RIGHT_READ
  • ZX_RIGHT_WAIT

錯誤

如果 resource 不是有效的帳號代碼，則為 ZX_ERR_BAD_HANDLE。

如果 resource 未處理資源物件，則為 ZX_ERR_WRONG_TYPE。

如果 resource 沒有最低權限，則為 ZX_ERR_ACCESS_DENIED。

如果 options 不是零，則為 ZX_ERR_INVALID_ARGS；out_port 不是有效指標，或 resource 並非適當的種類或基礎。

ZX_ERR_NO_MEMORY：如果作業因缺少系統記憶體而失敗。

另請參閱