Partager via


fonction PowerManagement_SetSystemPowerProfile

En-tête : #include <applibs/powermanagement.h>

Définit le profil d’alimentation du système. Le système ajuste dynamiquement la fréquence du processeur pour équilibrer la consommation d’énergie et les performances en fonction du profil d’alimentation spécifié.

int PowerManagement_SetSystemPowerProfile(PowerManagement_System_PowerProfile desired_profile);

Note

Les profils d’alimentation ne sont pas persistants entre les redémarrages et doivent toujours être définis au démarrage de votre application.

Paramètres

  • PowerManagement_PowerSaver indique que le système doit donner la priorité aux économies d’énergie par rapport aux performances.
  • PowerManagement_Balanced indique que le système doit équilibrer les économies d’énergie et les performances en fonction de la charge du système.
  • PowerManagement_HighPerformance indique que le système doit donner la priorité aux performances plutôt qu’aux économies d’énergie.

Erreurs

Retourne -1 si une erreur est rencontrée et définit errno sur la valeur d’erreur.

  • EACCES : l’accès à définir le profil d’alimentation système n’est pas autorisé, car l’entrée requise n’est pas répertoriée dans le manifeste de l’application.
  • EINVAL : un profil d’alimentation système non valide a été spécifié pour desired_profile.

Tout autre peut errno également être spécifié. Ces erreurs ne sont pas déterministes et le même comportement peut ne pas être conservé par le biais des mises à jour système.

Valeur de retour

Retourne 0 en cas de réussite ou -1 en cas d’échec, auquel cas errno est défini sur la valeur d’erreur.

Exigences du manifeste d’application

Pour utiliser PowerManagement_SetSystemPowerProfile(), votre application doit déclarer la valeur SetPowerProfile dans le champ PowerControls du manifeste de l’application.