USER_POWER_POLICY Struktur (powrprof.h)
Enthält Energierichtlinieneinstellungen, die für jedes Energieschema für einen Benutzer eindeutig sind. Diese Struktur ist Teil der POWER_POLICY-Struktur .
Syntax
typedef struct _USER_POWER_POLICY {
ULONG Revision;
POWER_ACTION_POLICY IdleAc;
POWER_ACTION_POLICY IdleDc;
ULONG IdleTimeoutAc;
ULONG IdleTimeoutDc;
UCHAR IdleSensitivityAc;
UCHAR IdleSensitivityDc;
UCHAR ThrottlePolicyAc;
UCHAR ThrottlePolicyDc;
SYSTEM_POWER_STATE MaxSleepAc;
SYSTEM_POWER_STATE MaxSleepDc;
ULONG Reserved[2];
ULONG VideoTimeoutAc;
ULONG VideoTimeoutDc;
ULONG SpindownTimeoutAc;
ULONG SpindownTimeoutDc;
BOOLEAN OptimizeForPowerAc;
BOOLEAN OptimizeForPowerDc;
UCHAR FanThrottleToleranceAc;
UCHAR FanThrottleToleranceDc;
UCHAR ForcedThrottleAc;
UCHAR ForcedThrottleDc;
} USER_POWER_POLICY, *PUSER_POWER_POLICY;
Member
Revision
Die aktuelle Strukturrevisionsebene. Legen Sie diesen Wert fest, indem Sie GetCurrentPowerPolicies oder ReadPwrScheme aufrufen, bevor Sie eine USER_POWER_POLICY Struktur zum Festlegen einer Energierichtlinie verwenden.
IdleAc
Eine POWER_ACTION_POLICY-Struktur , die die Systemstromaktion definiert, die ausgelöst werden soll, wenn das System mit Netzstrom (Versorgungsstrom) ausgeführt wird und der Leerlaufzeitgeber des Systems abläuft.
IdleDc
Eine POWER_ACTION_POLICY-Struktur , die die Netzbetriebsaktion des Systems definiert, die ausgelöst werden soll, wenn das System mit Batteriebetrieb ausgeführt wird und der System-Leerlaufzeitgeber abläuft.
IdleTimeoutAc
Die Zeit, zu der das Niveau der Systemaktivität unter dem Schwellenwert für die Leerlauferkennung bleiben muss, bevor der System-Leerlauftimer abläuft, wenn der Netzstrom (Hilfsprogramm) ausgeführt wird, in Sekunden.
Dieser Member wird ignoriert, wenn das System einen automatisierten Lebenslauf ausführt, da kein Benutzer vorhanden ist. Verwenden Sie die SetThreadExecutionState-Funktion , damit das System vorübergehend ausgeführt wird, während eine Anwendung eine Aufgabe ausführt.
IdleTimeoutDc
Die Zeit, zu der die Systemaktivität unter dem Schwellenwert für die Erkennung im Leerlauf bleiben muss, bevor der Leerlaufzeitgeber des Systems beim Betrieb mit Akkubetrieb abläuft, in Sekunden.
Dieser Member wird ignoriert, wenn das System einen automatisierten Lebenslauf ausführt, da kein Benutzer vorhanden ist. Verwenden Sie die SetThreadExecutionState-Funktion , damit das System vorübergehend ausgeführt wird, während eine Anwendung eine Aufgabe ausführt.
IdleSensitivityAc
Die Ebene der Systemaktivität, die den Schwellenwert für die Leerlauferkennung definiert, wenn das System mit Netzstrom (Versorgungsstrom) ausgeführt wird, ausgedrückt als Prozentsatz.
IdleSensitivityDc
Die Ebene der Systemaktivität, die den Schwellenwert für die Leerlauferkennung definiert, wenn das System mit Akkuleistung ausgeführt wird, ausgedrückt als Prozentsatz.
ThrottlePolicyAc
Die dynamische Einschränkungsrichtlinie des Prozessors, die verwendet werden soll, wenn das System mit Netzstrom (Hilfsprogramm) ausgeführt wird.
ThrottlePolicyDc
Die richtlinie für die dynamische Einschränkung des Prozessors, die verwendet werden soll, wenn das System mit Akkuleistung ausgeführt wird.
MaxSleepAc
Der maximale Ruhezustand des Systems, wenn das System mit Netzstrom (Hilfsprogramm) ausgeführt wird. Dieser Member muss einer der SYSTEM_POWER_STATE Enumerationstypwerte sein.
MaxSleepDc
Der maximale Ruhezustand des Systems, wenn das System mit Akkubetrieb ausgeführt wird. Dieser Member muss einer der SYSTEM_POWER_STATE Enumerationstypwerte sein.
Reserved[2]
Reserviert.
VideoTimeoutAc
Die Zeit, bevor die Anzeige ausgeschaltet wird, wenn das System mit Netzstrom (Hilfsprogramm) ausgeführt wird, in Sekunden.
VideoTimeoutDc
Die Zeit, bevor die Anzeige ausgeschaltet wird, wenn das System mit Akkubetrieb läuft, in Sekunden.
SpindownTimeoutAc
Die Zeit vor dem Einschalten von Festplattenlaufwerken wird deaktiviert, wenn das System mit Netzstrom (Hilfsprogramm) ausgeführt wird, in Sekunden.
SpindownTimeoutDc
Die Zeit vor dem Einschalten von Festplattenlaufwerken wird deaktiviert, wenn das System mit Akkubetrieb ausgeführt wird, in Sekunden.
OptimizeForPowerAc
Wenn dieses Element TRUE ist, schaltet das System kühle Lüfter ein und führt den Prozessor mit voller Geschwindigkeit aus, wenn eine passive Kühlung angegeben ist und das System mit Netzstrom (Versorgungsstrom) ausgeführt wird. Dies führt dazu, dass das Betriebssystem auf die Verwendung des Lüfters und die Ausführung des Prozessors mit voller Geschwindigkeit ausgerichtet ist.
OptimizeForPowerDc
Wenn dieses Element TRUE ist, schaltet das System kühle Lüfter ein und führt den Prozessor mit voller Geschwindigkeit aus, wenn die passive Kühlung angegeben ist und das System mit Akkuleistung ausgeführt wird. Dies führt dazu, dass das Betriebssystem auf die Verwendung des Lüfters und die Ausführung des Prozessors mit voller Geschwindigkeit ausgerichtet ist.
FanThrottleToleranceAc
Der untere Grenzwert, auf den der Prozessor vor dem Einschalten von Systemlüflümern als Reaktion auf ein thermisches Ereignis gedrosselt werden kann, während das System mit Netzstrom (Versorgungsstrom) arbeitet, ausgedrückt als Prozentsatz.
FanThrottleToleranceDc
Die untere Grenze, auf die der Prozessor vor dem Einschalten von Systemlüflümern als Reaktion auf ein thermisches Ereignis gedrosselt werden kann, während das System mit Akkuleistung arbeitet, ausgedrückt als Prozentsatz.
ForcedThrottleAc
Der Prozessordrosselungsgrad, der vom System auferlegt werden soll, während der Computer mit Netzstrom (Versorgungsstrom) ausgeführt wird, ausgedrückt als Prozentsatz.
ForcedThrottleDc
Der Prozessordrosselungsgrad, der vom System auferlegt werden soll, während der Computer mit Akkuleistung betrieben wird, ausgedrückt als Prozentsatz.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Kopfzeile | powrprof.h |