PowerManagement_ForceSystemPowerDown-Funktion

  • Artikel

Header: #include <applibs/powermanagement.h>

Erzwingt, dass das System für eine angegebene Anzahl von Sekunden in den Herunterschaltzustand versetzt wird.

Das Herunterfahren ist der niedrigste Energiesparzustand, in den das System eintreten kann, während er weiterhin von begrenzten externen Unterbrechungen oder automatisch nach einem Timeout reaktiviert werden kann.

Die Zeit, die im Zustand verbracht wird, kann kürzer sein, wenn ein externer Aktivierungsunterbrechung auftritt.

int PowerManagement_ForceSystemPowerDown(unsigned int maximum_residency_in_seconds);

Parameter

  • maximum_residency_in_seconds Die maximale Zeit (in Sekunden) kann sich das System in diesem Zustand befinden, bevor es wieder aktiv wird.

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_ForceSystemPowerDown() verwenden zu können, muss Ihre Anwendung den ForcePowerDown-Wert im Feld PowerControls des Anwendungsmanifests deklarieren.