Функция PowerManagement_SetSystemPowerProfile

  • Статья

Заголовок: #include <applibs/powermanagement.h>

Задает профиль питания системы. Система динамически настраивает частоту ЦП, чтобы сбалансировать энергопотребление и производительность в соответствии с указанным профилем питания.

int PowerManagement_SetSystemPowerProfile(PowerManagement_System_PowerProfile desired_profile);

Примечание

Профили питания не сохраняются при перезагрузках и всегда должны задаваться при запуске приложения.

Параметры

  • PowerManagement_PowerSaver указывает, что система должна уделять больше в первую очередь экономии электроэнергии производительности.
  • PowerManagement_Balanced указывает, что система должна распределять экономию электроэнергии и производительность в соответствии с нагрузкой на систему.
  • PowerManagement_HighPerformance указывает, что система должна отдавать приоритет производительности, а не экономии электроэнергии.

Ошибки

Возвращает значение -1 при обнаружении ошибки и задает errno значение ошибки.

  • EACCES: доступ к настройке профиля питания системы не разрешен, так как требуемая запись не указана в манифесте приложения.
  • EINVAL: для desired_profile указан недопустимый профиль питания системы.

Также можно указать любой другой errno параметр. Такие ошибки не являются детерминированными, и такое же поведение может не сохраняться при обновлении системы.

Возвращаемое значение

Возвращает значение 0 для успешного выполнения или -1 для сбоя. В этом случае errno будет задано значение ошибки.

Требования к манифесту приложения

Чтобы использовать PowerManagement_SetSystemPowerProfile(),приложение должно объявить значение SetPowerProfile в поле PowerControlsманифеста приложения.