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)

Weitere Informationen

CallNtPowerInformation

POWER_ACTION_POLICY

SYSTEM_POWER_LEVEL