Compartir vía


Función PowerManagement_SetSystemPowerProfile

Encabezado: #include <applibs/powermanagement.h>

Establece el perfil de energía del sistema. El sistema ajusta dinámicamente la frecuencia de la CPU para equilibrar el consumo de energía y el rendimiento según el perfil de energía especificado.

int PowerManagement_SetSystemPowerProfile(PowerManagement_System_PowerProfile desired_profile);

Nota

Los perfiles de energía no se conservan en los reinicios y siempre se deben establecer cuando se inicia la aplicación.

Parámetros

  • PowerManagement_PowerSaver indica que el sistema debe priorizar el ahorro de energía en lugar del rendimiento.
  • PowerManagement_Balanced indica que el sistema debe equilibrar el ahorro de energía y el rendimiento según la carga del sistema.
  • PowerManagement_HighPerformance indica que el sistema debe priorizar el rendimiento en lugar del ahorro de energía.

Errores

Devuelve -1 si se encuentra un error y se establece errno en el valor de error.

  • EACCES: no se permite el acceso para establecer el perfil de potencia del sistema, ya que la entrada requerida no aparece en el manifiesto de la aplicación.
  • EINVAL: se ha especificado un perfil de potencia del sistema no válido para desired_profile.

También se puede especificar cualquier otro errno . Estos errores no son deterministas y es posible que no se conserve el mismo comportamiento a través de las actualizaciones del sistema.

Valor devuelto

Devuelve 0 para éxito o -1 para error, en cuyo caso errno se establecerá en el valor de error.

Requisitos del manifiesto de la aplicación

Para usar PowerManagement_SetSystemPowerProfile(), la aplicación debe declarar el valor SetPowerProfile en el campo PowerControls del manifiesto de la aplicación.