Delen via


PowerManagement_SetSystemPowerProfile functie

Header: #include <applibs/powermanagement.h>

Hiermee stelt u het energieprofiel van het systeem in. Het systeem past de CPU-frequentie dynamisch aan om het energieverbruik en de prestaties in balans te houden volgens het opgegeven powerprofiel.

int PowerManagement_SetSystemPowerProfile(PowerManagement_System_PowerProfile desired_profile);

Opmerking

Stroomprofielen blijven niet behouden bij opnieuw opstarten en moeten altijd worden ingesteld wanneer uw toepassing wordt gestart.

Parameters

  • PowerManagement_PowerSaver geeft aan dat het systeem prioriteit moet geven aan energiebesparing boven prestaties.
  • PowerManagement_Balanced geeft aan dat het systeem energiebesparing en prestaties moet balancen op basis van de systeembelasting.
  • PowerManagement_HighPerformance geeft aan dat het systeem prioriteit moet geven aan prestaties boven energiebesparing.

Fouten

Retourneert -1 als er een fout optreedt en wordt ingesteld errno op de foutwaarde.

  • EACCES: toegang tot het instellen van het stroomprofiel van het systeem is niet toegestaan omdat de vereiste vermelding niet wordt vermeld in het toepassingsmanifest.
  • EINVAL: er is een ongeldig systeemstroomprofiel opgegeven voor desired_profile.

Alle andere errno kunnen ook worden opgegeven. Dergelijke fouten zijn niet deterministisch en hetzelfde gedrag wordt mogelijk niet behouden via systeemupdates.

Retourwaarde

Retourneert 0 voor geslaagd of -1 voor fout, in welk geval errno wordt ingesteld op de foutwaarde.

Vereisten voor toepassingsmanifest

Als u PowerManagement_SetSystemPowerProfile() wilt gebruiken, moet uw toepassing de waarde SetPowerProfile declareren in het veld PowerControls van het toepassingsmanifest.