Sdílet prostřednictvím

PowerManagement_SetSystemPowerProfile Funkce

  • Článek

Hlavička: #include <applibs/powermanagement.h>

Nastaví profil napájení systému. Systém dynamicky upravuje frekvenci procesoru tak, aby vyvažovaly spotřebu energie a výkon podle zadaného profilu napájení.

int PowerManagement_SetSystemPowerProfile(PowerManagement_System_PowerProfile desired_profile);

Poznámka

Profily napájení se při restartování neuchovávají a měly by se vždy nastavit při spuštění aplikace.

Parametry

  • PowerManagement_PowerSaver značí, že systém by měl upřednostnit úspory energie před výkonem.
  • PowerManagement_Balanced značí, že systém by měl vyrovnávat úspory energie a výkon v závislosti na zatížení systému.
  • PowerManagement_HighPerformance značí, že systém by měl upřednostnit výkon před úsporami energie.

Chyby

Vrátí hodnotu -1, pokud dojde k chybě, a nastaví errno se na chybovou hodnotu.

  • EACCES: Přístup k nastavení profilu napájení systému není povolen, protože požadovaná položka není uvedená v manifestu aplikace.
  • EINVAL: Pro desired_profile byl zadán neplatný profil napájení systému.

Mohou být také zadány všechny ostatní errno . Takové chyby nejsou deterministické a stejné chování nemusí být zachováno prostřednictvím aktualizací systému.

Vrácená hodnota

Vrátí hodnotu 0 pro úspěch nebo -1 pro selhání. V tomto případě errno se nastaví na chybovou hodnotu.

Požadavky manifestu aplikace

Pokud chcete použít PowerManagement_SetSystemPowerProfile(), musí aplikace deklarovat hodnotu SetPowerProfile v poli PowerControlsmanifestu aplikace.