Dela via


funktionen PowerManagement_SetSystemPowerProfile

Sidhuvud: #include <applibs/powermanagement.h>

Anger systemets energiprofil. Systemet justerar cpu-frekvensen dynamiskt för att balansera energiförbrukning och prestanda enligt den angivna energiprofilen.

int PowerManagement_SetSystemPowerProfile(PowerManagement_System_PowerProfile desired_profile);

Observera

Energiprofiler finns inte kvar i alla omstarter och ska alltid ställas in när programmet startas.

Parametrar

  • PowerManagement_PowerSaver anger att systemet bör prioritera energisparfunktioner framför prestanda.
  • PowerManagement_Balanced anger att systemet ska balansera energibesparingar och prestanda efter systembelastning.
  • PowerManagement_HighPerformance anger att systemet bör prioritera prestanda framför energibesparingar.

Fel

Returnerar -1 om ett fel uppstår och anger errno felvärdet.

  • EACCES: åtkomst till att ange systemenergiprofil tillåts inte eftersom den obligatoriska posten inte visas i programmanifestet.
  • EINVAL: en ogiltig systemenergiprofil angavs för desired_profile.

errno Andra kan också anges. Sådana fel är inte deterministiska och samma beteende kanske inte behålls via systemuppdateringar.

Returvärde

Returnerar 0 för framgång eller -1 för fel, i vilket fall errno anges till felvärdet.

Krav för programmanifest

Om du vill använda PowerManagement_SetSystemPowerProfile()måste programmet deklarera värdet SetPowerProfile i fältet PowerControls i programmanifestet.