Função PowerManagement_SetSystemPowerProfile
Cabeçalho: #include <applibs/powermanagement.h>
Define o perfil de energia do sistema. O sistema ajusta dinamicamente a frequência da CPU para equilibrar o consumo de energia e o desempenho de acordo com o Perfil do Power especificado.
int PowerManagement_SetSystemPowerProfile(PowerManagement_System_PowerProfile desired_profile);
Nota
Os perfis de energia não persistem entre reinicializações e devem ser sempre definidos quando o aplicativo for iniciado.
Parâmetros
-
PowerManagement_PowerSaver
indica que o sistema deve priorizar a economia de energia em relação ao desempenho. -
PowerManagement_Balanced
indica que o sistema deve equilibrar a economia de energia e o desempenho de acordo com a carga do sistema. -
PowerManagement_HighPerformance
indica que o sistema deve priorizar o desempenho em relação à economia de energia.
Erros
Retorna -1 se um erro for encontrado e definir errno
como o valor do erro.
- EACCES: o acesso para definir o perfil de energia do sistema não é permitido, pois a entrada necessária não está listada no manifesto do aplicativo.
- EINVAL: um perfil de energia inválido do sistema foi especificado para desired_profile.
Qualquer outra errno
também pode ser especificada. Esses erros não são determinísticos e o mesmo comportamento pode não ser mantido por meio de atualizações do sistema.
Valor retornado
Retorna 0 para êxito ou -1 para falha, nesse caso errno
, será definido como o valor do erro.
Requisitos de manifesto do aplicativo
Para usar PowerManagement_SetSystemPowerProfile(), seu aplicativo deve declarar o valor SetPowerProfile no campo PowerControls do manifesto do aplicativo.