PowerManagement_SetSystemPowerProfile函數

  • 發行項

頁首： #include < applibs/powermanagement。h>

設定系統電源設定檔。 系統會動態調整 CPU 頻率，以根據指定的 Power Profile 來平衡耗電量和效能。

int PowerManagement_SetSystemPowerProfile(PowerManagement_System_PowerProfile desired_profile);

注意

電源設定檔不會在重新開機時持續存在，而且應該在應用程式啟動時一律設定。

參數

  • PowerManagement_PowerSaver 表示系統應優先于效能節省電力。
  • PowerManagement_Balanced 表示系統應根據系統負載來平衡省電與效能。
  • PowerManagement_HighPerformance 表示系統應將效能優先于省電。

錯誤

如果發生錯誤並設定為 errno 錯誤值，則傳回 -1。

  • EACCES：無法存取設定系統電源設定檔，因為必要專案不會列在應用程式資訊清單中。
  • EINVAL：已針對 desired_profile 指定不正確系統電源設定檔。

您也可以指定任何其他 errno 專案。 這類錯誤不是不確定的，同樣的行為可能無法透過系統更新來保留。

傳回值

傳回 0 表示成功，傳回 -1 表示失敗，在這種情況下 errno 會設定為錯誤值。

應用程式資訊清單需求

若要使用PowerManagement_SetSystemPowerProfile () ，您的應用程式必須在應用程式資訊清單的PowerControls欄位中宣告SetPowerProfile值。