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)

Vedi anche

CallNtPowerInformation

POWER_ACTION_POLICY

SYSTEM_POWER_LEVEL