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)

Confira também

CallNtPowerInformation

POWER_ACTION_POLICY

SYSTEM_POWER_LEVEL