SYSTEM_POWER_POLICY-Struktur (winnt.h)
Enthält Informationen zur aktuellen Systemenergierichtlinie.
Syntax
typedef struct _SYSTEM_POWER_POLICY {
DWORD Revision;
POWER_ACTION_POLICY PowerButton;
POWER_ACTION_POLICY SleepButton;
POWER_ACTION_POLICY LidClose;
SYSTEM_POWER_STATE LidOpenWake;
DWORD Reserved;
POWER_ACTION_POLICY Idle;
DWORD IdleTimeout;
BYTE IdleSensitivity;
BYTE DynamicThrottle;
BYTE Spare2[2];
SYSTEM_POWER_STATE MinSleep;
SYSTEM_POWER_STATE MaxSleep;
SYSTEM_POWER_STATE ReducedLatencySleep;
DWORD WinLogonFlags;
DWORD Spare3;
DWORD DozeS4Timeout;
DWORD BroadcastCapacityResolution;
SYSTEM_POWER_LEVEL DischargePolicy[NUM_DISCHARGE_POLICIES];
DWORD VideoTimeout;
BOOLEAN VideoDimDisplay;
DWORD VideoReserved[3];
DWORD SpindownTimeout;
BOOLEAN OptimizeForPower;
BYTE FanThrottleTolerance;
BYTE ForcedThrottle;
BYTE MinThrottle;
POWER_ACTION_POLICY OverThrottled;
} SYSTEM_POWER_POLICY, *PSYSTEM_POWER_POLICY;
Member
Revision
Die aktuelle Strukturrevision.
PowerButton
Eine POWER_ACTION_POLICY-Struktur , die die Systembetriebsaktion definiert, die beim Drücken des Netzschalters des Systems ausgelöst werden soll.
SleepButton
Eine POWER_ACTION_POLICY-Struktur , die die Systembetriebsaktion definiert, die beim Drücken der Systemmodustaste ausgelöst werden soll.
LidClose
Eine POWER_ACTION_POLICY-Struktur , die die Systembetriebsaktion definiert, die beim Schließen des Systemdeckelschalters ausgelöst werden soll.
LidOpenWake
Der maximale Leistungszustand (höchster Sx-Wert), aus dem ein Lid-Open-Ereignis das System reaktivieren soll. Dieser Member muss einer der SYSTEM_POWER_STATE Enumerationstypwerte sein.
Reserved
Reserviert.
Idle
Eine POWER_ACTION_POLICY-Struktur , die die Systemleistungsaktion definiert, die beim Ablauf des System-Leerlauftimers ausgelöst werden soll.
IdleTimeout
Die Zeit, zu der die Ebene der Systemaktivität unter dem Schwellenwert für die Leerlauferkennung bleiben muss, bevor der System-Leerlaufzeitgeber abläuft, in Sekunden.
IdleSensitivity
Die Ebene der Systemaktivität, die den Schwellenwert für die Leerlauferkennung definiert, ausgedrückt als Prozentsatz.
DynamicThrottle
Die aktuelle dynamische Einschränkungsrichtlinie des Systemprozessors. Dieser Member muss einer der unter Richtlinienkonstanten der Prozessorleistungssteuerung beschriebenen Werte sein.
Spare2[2]
Reserviert.
MinSleep
Der minimale Systemmoduszustand (niedrigster Sx-Wert) wird derzeit unterstützt. Dieser Member muss einer der SYSTEM_POWER_STATE Enumerationstypwerte sein.
MaxSleep
Der maximale Systemmoduszustand (höchster Sx-Wert) wird derzeit unterstützt. Dieser Member muss einer der SYSTEM_POWER_STATE Enumerationstypwerte sein.
ReducedLatencySleep
Der Systemleistungsstatus (Sx-Wert), der bei einer Systemmodusaktion eingegeben werden soll, wenn die Latenzanforderungen ausstehen. Dieser Member muss einer der SYSTEM_POWER_STATE Enumerationstypwerte sein. Wenn eine Anwendung RequestWakeupLatency mit LT_LOWEST_LATENCY aufruft, wird ReducedLatencySleep anstelle von MaxSleep verwendet.
WinLogonFlags
Dieser Member kann null oder WINLOGON_LOCK_ON_SLEEP (0x00000001) sein.
Spare3
Reserviert.
DozeS4Timeout
Die Wartezeit zwischen dem Betreten des Ruhezustands und dem Eintritt in den Ruhezustand in Sekunden. Ein Wert von 0 gibt an, dass nie in den Ruhezustand versetzt wird.
BroadcastCapacityResolution
Die Auflösung der Änderung der aktuellen Akkukapazität, die dazu führen sollte, dass das System über ein Ereignis zum Ändern des Systemstromzustands benachrichtigt wird.
DischargePolicy[NUM_DISCHARGE_POLICIES]
Ein Array von SYSTEM_POWER_LEVEL Strukturen, das die Aktionen definiert, die bei Systembatterieentladungsereignissen ausgeführt werden sollen.
VideoTimeout
Die Zeit, bevor die Anzeige deaktiviert wird, in Sekunden.
VideoDimDisplay
Wenn dieser Member TRUE ist, bietet das System Unterstützung für das Dimmen der Anzeige.
VideoReserved[3]
Reserviert.
SpindownTimeout
Die Zeit vor dem Einschalten von Festplattenlaufwerken in Sekunden.
OptimizeForPower
Wenn dieses Element TRUE ist, schaltet das System Die Lüfter ein und führt den Prozessor mit voller Geschwindigkeit aus, wenn die passive Kühlung angegeben ist. Dies führt dazu, dass das Betriebssystem auf die Verwendung des Lüfters und die Ausführung des Prozessors mit voller Geschwindigkeit ausgerichtet ist.
FanThrottleTolerance
Die untere Grenze, auf die der Prozessor vor dem Einschalten von Systemlüflümern als Reaktion auf ein thermisches Ereignis gedrosselt werden kann, ausgedrückt als Prozentsatz.
ForcedThrottle
Die vom System zu verhängende Drosselungsebene des Prozessors, ausgedrückt als Prozentsatz.
MinThrottle
Der minimale Prozessordrosselungsgrad, ausgedrückt als Prozentsatz.
OverThrottled
Eine POWER_ACTION_POLICY-Struktur , die die Systemleistungsaktion definiert, die als Reaktion auf ein thermisches Ereignis initiiert werden soll, wenn die Prozessordrosselung die Systemtemperatur nicht ausreichend reduzieren kann.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Kopfzeile | winnt.h (Einschließen von Windows.h) |