MACHINE_POWER_POLICY Struktur (powrprof.h)
Enthält Energierichtlinieneinstellungen für Computer, die für jedes Energieschema auf dem Computer eindeutig sind. Diese Struktur ist Teil der POWER_POLICY-Struktur .
Syntax
typedef struct _MACHINE_POWER_POLICY {
ULONG Revision;
SYSTEM_POWER_STATE MinSleepAc;
SYSTEM_POWER_STATE MinSleepDc;
SYSTEM_POWER_STATE ReducedLatencySleepAc;
SYSTEM_POWER_STATE ReducedLatencySleepDc;
ULONG DozeTimeoutAc;
ULONG DozeTimeoutDc;
ULONG DozeS4TimeoutAc;
ULONG DozeS4TimeoutDc;
UCHAR MinThrottleAc;
UCHAR MinThrottleDc;
UCHAR pad1[2];
POWER_ACTION_POLICY OverThrottledAc;
POWER_ACTION_POLICY OverThrottledDc;
} MACHINE_POWER_POLICY, *PMACHINE_POWER_POLICY;
Member
Revision
Die aktuelle Strukturrevisionsebene. Legen Sie diesen Wert fest, indem Sie GetCurrentPowerPolicies oder ReadPwrScheme aufrufen, bevor Sie eine MACHINE_POWER_POLICY Struktur zum Festlegen einer Energierichtlinie verwenden.
MinSleepAc
Der minimale Systemleistungszustand (niedrigster Sx-Wert), der bei einer Systemmodusaktion im Standbymodus eingegeben werden soll, wenn sie mit Netzstrom ausgeführt wird. Dieser Member muss einer der SYSTEM_POWER_STATE Enumerationstypwerte sein.
MinSleepDc
Der minimale Systemleistungszustand (niedrigster Sx-Wert), der bei einer Systemruhemodusaktion beim Betrieb mit Akkubetrieb eingegeben werden soll. Dieser Member muss einer der SYSTEM_POWER_STATE Enumerationstypwerte sein.
ReducedLatencySleepAc
Der maximale Systemleistungszustand (höchster Sx-Wert), der bei einer Systemmodusaktion im Standbymodus eingegeben werden soll, wenn die Netzstromleistung ausgeführt wird, und wenn hervorragende Latenzanforderungen bestehen. Dieser Member muss einer der SYSTEM_POWER_STATE Enumerationstypwerte sein. Wenn eine Anwendung RequestWakeupLatency mit LT_LOWEST_LATENCY aufruft, wird ReducedLatencySleepAc anstelle von MaxSleepAc verwendet.
ReducedLatencySleepDc
Der maximale Systemleistungszustand (höchster Sx-Wert), der bei einer Systemmodusaktion eingegeben werden soll, wenn der Akkubetrieb ausgeführt wird, und wenn hervorragende Latenzanforderungen bestehen. Dieser Member muss einer der SYSTEM_POWER_STATE Enumerationstypwerte sein. Wenn eine Anwendung RequestWakeupLatency mit LT_LOWEST_LATENCY aufruft, wird ReducedLatencySleepAc anstelle von MaxSleepAc verwendet.
DozeTimeoutAc
Dieses Element wird ignoriert.
DozeTimeoutDc
Dieses Element wird ignoriert.
DozeS4TimeoutAc
Wartezeit zwischen dem Eintritt in den Angehalten-Zustand und dem Eintritt in den Ruhezustand, wenn das System mit Netzstrom ausgeführt wird, in Sekunden. Ein Wert von 0 gibt an, dass nie in den Ruhezustand versetzt wird.
DozeS4TimeoutDc
Wartezeit zwischen dem Betreten des Ruhezustands und dem Eintritt in den Ruhezustand, wenn das System mit Akkubetrieb ausgeführt wird, in Sekunden. Ein Wert von 0 gibt an, dass nie in den Ruhezustand versetzt wird.
MinThrottleAc
Die minimale Drosselungseinstellung, die vor der Überdrosselung zulässig ist, wenn das System mit Netzstrom ausgeführt wird. Thermische Bedingungen wären der einzige Grund, um unter die Mindesteinstellung zu gehen. Wenn der Prozessor überdrosselt wird, initiiert das System die Richtlinie "OverThrottledAc" . Beachten Sie, dass der Energierichtlinien-Manager über eine hartcodierte Richtlinie zum Initiieren eines CriticalShutdownOff verfügt, wenn eine thermische Zone auf einen kritischen thermischen Zustand hinweist. Bereich: 0-100.
MinThrottleDc
Die minimale Drosselungseinstellung, die vor der Überdrosselung zulässig ist, wenn das System mit Akkubetrieb ausgeführt wird. Thermische Bedingungen wären der einzige Grund, um unter die Mindesteinstellung zu gehen. Wenn der Prozessor überdrosselt wird, initiiert das System die Richtlinie "OverThrottledDc" . Beachten Sie, dass der Energierichtlinien-Manager über eine hartcodierte Richtlinie zum Initiieren eines CriticalShutdownOff verfügt, wenn eine thermische Zone auf einen kritischen thermischen Zustand hinweist. Bereich: 0-100.
pad1[2]
Reserviert.
OverThrottledAc
Eine POWER_ACTION_POLICY-Struktur , die die Aktion definiert, die ausgeführt werden soll, wenn ein Prozessor überdrosselt wurde (wie vom MinThrottleAc-Element definiert), wenn das System mit Netzstrom ausgeführt wird.
OverThrottledDc
Eine POWER_ACTION_POLICY-Struktur , die die Aktion definiert, die ausgeführt werden soll, wenn ein Prozessor überdrosselt wurde (wie vom MinThrottleDc-Element definiert), wenn das System mit Akkuleistung ausgeführt wird.
Hinweise
DozeS4TimeoutAc und DozeS4TimeoutDc entsprechen dem DozeS4Timeout-Member von SYSTEM_POWER_POLICY. Diese Werte werden aus der Computerenergierichtlinie mit der Systemenergierichtlinie zusammengeführt, wenn die Funktion SetActivePwrScheme aufgerufen wird, um ein Energieschema anzuwenden.
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 |