Freigeben über


PowerManagement_SetSystemPowerProfile-Funktion

Header: #include <applibs/powermanagement.h>

Legt das Systemleistungsprofil fest. Das System passt die CPU-Frequenz dynamisch an, um den Energieverbrauch und die Leistung entsprechend dem angegebenen Energieprofil auszugleichen.

int PowerManagement_SetSystemPowerProfile(PowerManagement_System_PowerProfile desired_profile);

Hinweis

Energieprofile werden nicht über Neustarts hinweg beibehalten und sollten immer festgelegt werden, wenn Ihre Anwendung gestartet wird.

Parameter

  • PowerManagement_PowerSaver gibt an, dass das System Stromeinsparungen gegenüber der Leistung priorisieren sollte.
  • PowerManagement_Balanced gibt an, dass das System Stromeinsparungen und Leistung entsprechend der Systemlast ausgleichen soll.
  • PowerManagement_HighPerformance gibt an, dass das System die Leistung vor Energieeinsparungen priorisieren sollte.

Fehler

Gibt -1 zurück, wenn ein Fehler auftritt, und legt auf den Fehlerwert fest errno .

  • EACCES: Der Zugriff zum Festlegen des Systemleistungsprofils ist nicht zulässig, da der erforderliche Eintrag nicht im Anwendungsmanifest aufgeführt ist.
  • EINVAL: Für desired_profile wurde ein ungültiges Systemleistungsprofil angegeben.

Alle anderen errno können ebenfalls angegeben werden. Solche Fehler sind nicht deterministisch, und dasselbe Verhalten wird möglicherweise nicht durch Systemupdates beibehalten.

Rückgabewert

Gibt 0 für erfolg oder -1 für Fehler zurück. In diesem Fall errno wird auf den Fehlerwert festgelegt.

Anforderungen an das Anwendungsmanifest

Um PowerManagement_SetSystemPowerProfile() verwenden zu können, muss Ihre Anwendung den SetPowerProfile-Wert im Feld PowerControls des Anwendungsmanifests deklarieren.