Udostępnij za pośrednictwem

Funkcja PowerManagement_SetSystemPowerProfile

  • Artykuł

Nagłówek: #include <applibs/powermanagement.h>

Ustawia profil zasilania systemu. System dynamicznie dostosowuje częstotliwość procesora, aby zrównoważyć zużycie energii i wydajność zgodnie z określonym profilem zasilania.

int PowerManagement_SetSystemPowerProfile(PowerManagement_System_PowerProfile desired_profile);

Uwaga

Profile zasilania nie są zachowywane podczas ponownego uruchamiania i powinny być zawsze ustawiane podczas uruchamiania aplikacji.

Parametry

  • PowerManagement_PowerSaver oznacza, że system powinien priorytetowo traktować oszczędzanie energii w stosunku do wydajności.
  • PowerManagement_Balanced wskazuje, że system powinien równoważyć oszczędności energii i wydajność w zależności od obciążenia systemu.
  • PowerManagement_HighPerformance oznacza, że system powinien priorytetowo traktować wydajność w stosunku do oszczędzania energii.

Błędy

Zwraca wartość -1 w przypadku napotkania błędu i ustawia errno wartość błędu.

  • EACCES: dostęp do ustawień profilu zasilania systemu jest niedozwolony, ponieważ wymagany wpis nie jest wymieniony w manifeście aplikacji.
  • EINVAL: dla desired_profile określono nieprawidłowy profil zasilania systemu.

Mogą być również określone inne errno . Takie błędy nie są deterministyczne i to samo zachowanie może nie być zachowane za pośrednictwem aktualizacji systemu.

Zwracana wartość

Zwraca wartość 0 dla sukcesu lub -1 dla niepowodzenia, w którym to przypadku errno zostanie ustawiona wartość błędu.

Wymagania dotyczące manifestu aplikacji

Aby użyć PowerManagement_SetSystemPowerProfile(), aplikacja musi zadeklarować wartość SetPowerProfile w polu PowerControlsmanifestu aplikacji.