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 de Energia especificado.

int PowerManagement_SetSystemPowerProfile(PowerManagement_System_PowerProfile desired_profile);

Nota

Os perfis de energia não persistem entre reinícios e devem ser sempre definidos quando a aplicação é iniciada.

Parâmetros

• PowerManagement_PowerSaver indica que o sistema deve priorizar a poupança de energia em vez do desempenho.
• PowerManagement_Balanced indica que o sistema deve equilibrar a poupança de energia e o desempenho de acordo com a carga do sistema.
• PowerManagement_HighPerformance indica que o sistema deve priorizar o desempenho em vez da poupança de energia.

Erros

Devolve -1 se for encontrado um erro e define errno para o valor de erro.

• EACCES: o acesso para definir o perfil de energia do sistema não é permitido, uma vez que a entrada necessária não está listada no manifesto da aplicação.
• EINVAL: foi especificado um perfil de energia do sistema inválido para desired_profile.

Qualquer outro errno também pode ser especificado. Estes erros não são deterministas e o mesmo comportamento pode não ser retido através de atualizações do sistema.

Valor devolvido

Devolve 0 para êxito ou -1 para falha, caso errno em que será definido como o valor de erro.

Requisitos do manifesto de aplicação

Para utilizar PowerManagement_SetSystemPowerProfile(), a aplicação tem de declarar o valor SetPowerProfile no campo PowerControls do manifesto da aplicação.