Compartilhar via


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.