estrutura SYSTEM_POWER_POLICY (winnt.h)
Contém informações sobre a política de energia do sistema atual.
Sintaxe
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;
Membros
Revision
A revisão da estrutura atual.
PowerButton
Uma estrutura POWER_ACTION_POLICY que define a ação de energia do sistema a ser iniciada quando o botão de energia do sistema é pressionado.
SleepButton
Uma estrutura POWER_ACTION_POLICY que define a ação de energia do sistema a ser iniciada quando o botão de suspensão do sistema é pressionado.
LidClose
Uma estrutura POWER_ACTION_POLICY que define a ação de energia do sistema a ser iniciada quando o comutador de tampa do sistema é fechado.
LidOpenWake
O estado máximo de energia (valor Sx mais alto) do qual um evento aberto por tampa deve ativar o sistema. Esse membro deve ser um dos valores de tipo de enumeração SYSTEM_POWER_STATE.
Reserved
Reservado.
Idle
Uma estrutura POWER_ACTION_POLICY que define a ação de energia do sistema a ser iniciada quando o temporizador ocioso do sistema expira.
IdleTimeout
O tempo em que o nível de atividade do sistema deve permanecer abaixo do limite de detecção ociosa antes que o temporizador ocioso do sistema expire, em segundos.
IdleSensitivity
O nível de atividade do sistema que define o limite para detecção ociosa, expresso como uma porcentagem.
DynamicThrottle
A política de limitação dinâmica do processador do sistema atual. Esse membro deve ser um dos valores descritos em Constantes de Política de Controle de Desempenho do Processador.
Spare2[2]
Reservado.
MinSleep
Atualmente, há suporte para o estado de suspensão mínimo do sistema (valor Sx mais baixo). Esse membro deve ser um dos valores de tipo de enumeração SYSTEM_POWER_STATE.
MaxSleep
Atualmente, há suporte para o estado de suspensão máximo do sistema (valor Sx mais alto). Esse membro deve ser um dos valores de tipo de enumeração SYSTEM_POWER_STATE.
ReducedLatencySleep
O estado de energia do sistema (valor Sx) a ser inserido em uma ação de suspensão do sistema quando houver requisitos de latência pendentes. Esse membro deve ser um dos valores de tipo de enumeração SYSTEM_POWER_STATE. Se um aplicativo chamar RequestWakeupLatency com LT_LOWEST_LATENCY, ReducedLatencySleep será usado no lugar de MaxSleep.
WinLogonFlags
Esse membro pode ser zero ou WINLOGON_LOCK_ON_SLEEP (0x00000001).
Spare3
Reservado.
DozeS4Timeout
O tempo de espera entre entrar no estado de suspensão e entrar no estado de suspensão hibernação, em segundos. Um valor igual a zero indica nunca hibernar.
BroadcastCapacityResolution
A resolução da alteração na capacidade atual da bateria que deve fazer com que o sistema seja notificado de um evento de alteração do estado de energia do sistema.
DischargePolicy[NUM_DISCHARGE_POLICIES]
Uma matriz de estruturas de SYSTEM_POWER_LEVEL que define as ações a serem tomadas em eventos de descarga de bateria do sistema.
VideoTimeout
O tempo antes da exibição ser desativada, em segundos.
VideoDimDisplay
Se esse membro for TRUE, o sistema incluirá suporte para escurecimento de exibição.
VideoReserved[3]
Reservado.
SpindownTimeout
O tempo antes de a energia para unidades de disco fixas ser desativada, em segundos.
OptimizeForPower
Se esse membro for TRUE, o sistema ativará os ventiladores de resfriamento e executará o processador a toda velocidade quando o resfriamento passivo for especificado. Isso faz com que o sistema operacional seja tendencioso em relação ao uso do ventilador e à execução do processador a toda velocidade.
FanThrottleTolerance
O limite inferior ao qual o processador pode ser limitado antes de ativar os ventiladores do sistema em resposta a um evento térmico, expresso como uma porcentagem.
ForcedThrottle
O nível de aceleração do processador a ser imposto pelo sistema, expresso como uma porcentagem.
MinThrottle
O nível mínimo de aceleração do processador, expresso como uma porcentagem.
OverThrottled
Uma estrutura POWER_ACTION_POLICY que define a ação de energia do sistema a ser iniciada em resposta a um evento térmico quando a limitação do processador não consegue reduzir adequadamente a temperatura do sistema.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows XP [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
| Cabeçalho | winnt.h (inclua Windows.h) |