SYSTEM_POWER_POLICY struttura (winnt.h)
Contiene informazioni sui criteri di alimentazione del sistema correnti.
Sintassi
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;
Members
Revision
Revisione della struttura corrente.
PowerButton
Struttura POWER_ACTION_POLICY che definisce l'azione di alimentazione del sistema da avviare quando viene premuto il pulsante di alimentazione del sistema.
SleepButton
Struttura POWER_ACTION_POLICY che definisce l'azione di alimentazione del sistema da avviare quando viene premuto il pulsante di sospensione del sistema.
LidClose
Struttura POWER_ACTION_POLICY che definisce l'azione di alimentazione del sistema da avviare quando l'interruttore del coperchio del sistema è chiuso.
LidOpenWake
Stato massimo di alimentazione (valore Sx più alto) da cui deve essere riattivato un evento di apertura del coperchio. Questo membro deve essere uno dei valori di tipo di enumerazione SYSTEM_POWER_STATE .
Reserved
Riservato.
Idle
Struttura POWER_ACTION_POLICY che definisce l'azione di alimentazione del sistema da avviare alla scadenza del timer di inattività del sistema.
IdleTimeout
Ora in cui il livello di attività di sistema deve rimanere al di sotto della soglia di rilevamento inattiva prima della scadenza del timer di inattività del sistema, in secondi.
IdleSensitivity
Livello di attività di sistema che definisce la soglia per il rilevamento inattiva, espresso come percentuale.
DynamicThrottle
Criterio di limitazione dinamica del processore di sistema corrente. Questo membro deve essere uno dei valori descritti in Costanti dei criteri di controllo prestazioni processore.
Spare2[2]
Riservato.
MinSleep
Lo stato minimo di sospensione del sistema (valore Sx minimo) attualmente supportato. Questo membro deve essere uno dei valori di tipo di enumerazione SYSTEM_POWER_STATE .
MaxSleep
Attualmente supportato lo stato massimo di sospensione del sistema (valore Sx più alto). Questo membro deve essere uno dei valori di tipo di enumerazione SYSTEM_POWER_STATE .
ReducedLatencySleep
Lo stato di alimentazione del sistema (valore Sx) per immettere un'azione di sospensione del sistema quando sono presenti requisiti di latenza in sospeso. Questo membro deve essere uno dei valori di tipo di enumerazione SYSTEM_POWER_STATE . Se un'applicazione chiama RequestWakeupLatency con LT_LOWEST_LATENCY, ReducedLatencySleep verrà usato al posto di MaxSleep.
WinLogonFlags
Questo membro può essere zero o WINLOGON_LOCK_ON_SLEEP (0x00000001).
Spare3
Riservato.
DozeS4Timeout
Tempo di attesa tra l'immissione dello stato di sospensione e l'immissione dello stato di sospensione, in secondi. Un valore pari a zero indica mai l'ibernazione.
BroadcastCapacityResolution
La risoluzione della modifica della capacità della batteria corrente che dovrebbe causare la notifica del sistema a un evento di stato di alimentazione del sistema modificato.
DischargePolicy[NUM_DISCHARGE_POLICIES]
Matrice di strutture SYSTEM_POWER_LEVEL che definisce le azioni da eseguire agli eventi di scaricamento della batteria del sistema.
VideoTimeout
Tempo prima che la visualizzazione venga disattivata, in secondi.
VideoDimDisplay
Se questo membro è TRUE, il sistema include il supporto per la rimozione della visualizzazione.
VideoReserved[3]
Riservato.
SpindownTimeout
Il tempo prima dell'alimentazione delle unità disco fisse viene disattivato, in secondi.
OptimizeForPower
Se questo membro è TRUE, il sistema attiva i fan di raffreddamento ed esegue il processore a velocità completa quando viene specificato il raffreddamento passivo. In questo modo il sistema operativo deve essere pregiudiziato verso l'uso della ventola e l'esecuzione del processore a velocità completa.
FanThrottleTolerance
Limite inferiore a cui il processore può essere limitato prima di attivare i fan del sistema in risposta a un evento termica, espresso come percentuale.
ForcedThrottle
Livello di limitazione del processore da imporre dal sistema, espresso come percentuale.
MinThrottle
Livello minimo di limitazione del processore, espresso come percentuale.
OverThrottled
Una struttura POWER_ACTION_POLICY che definisce l'azione di alimentazione del sistema da avviare in risposta a un evento termica quando la limitazione del processore non è in grado di ridurre adeguatamente la temperatura del sistema.
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Windows XP [solo app desktop] |
Server minimo supportato | Windows Server 2003 [solo app desktop] |
Intestazione | winnt.h (includere Windows.h) |