estrutura MACHINE_POWER_POLICY (powrprof.h)

Contém as configurações de política de energia do computador que são exclusivas para cada esquema de energia no computador. Essa estrutura faz parte da estrutura POWER_POLICY .

Sintaxe

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;

Membros

Revision

O nível de revisão da estrutura atual. Defina esse valor chamando GetCurrentPowerPolicies ou ReadPwrScheme antes de usar uma estrutura MACHINE_POWER_POLICY para definir a política de energia.

MinSleepAc

O estado mínimo de energia do sistema (valor Sx mais baixo) a ser inserido em uma ação de suspensão do sistema durante a execução na energia AC. Esse membro deve ser um dos valores de tipo de enumeração SYSTEM_POWER_STATE.

MinSleepDc

O estado mínimo de energia do sistema (valor Sx mais baixo) a ser inserido em uma ação de suspensão do sistema ao executar a energia da bateria. Esse membro deve ser um dos valores de tipo de enumeração SYSTEM_POWER_STATE.

ReducedLatencySleepAc

O estado máximo de energia do sistema (valor Sx mais alto) a ser inserido em uma ação de suspensão do sistema durante a execução na energia ac e quando há 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, ReducedLatencySleepAc será usado no lugar de MaxSleepAc.

ReducedLatencySleepDc

O estado máximo de energia do sistema (valor Sx mais alto) a ser inserido em uma ação de suspensão do sistema durante a execução na energia da bateria e quando há 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, ReducedLatencySleepAc será usado no lugar de MaxSleepAc.

DozeTimeoutAc

Esse membro é ignorado.

DozeTimeoutDc

Esse membro é ignorado.

DozeS4TimeoutAc

Tempo para aguardar entre entrar no estado de suspensão e entrar no estado de suspensão hibernação quando o sistema estiver em execução na energia AC, em segundos. Um valor igual a zero indica nunca hibernar.

DozeS4TimeoutDc

Tempo para aguardar entre entrar no estado de suspensão e entrar no estado de suspensão hibernação quando o sistema estiver em execução na energia da bateria, em segundos. Um valor igual a zero indica nunca hibernar.

MinThrottleAc

A configuração de limitação mínima permitida antes de ser superestimada quando o sistema está em execução na energia AC. As condições térmicas seriam o único motivo para ficar abaixo da configuração mínima. Quando o processador for sobrecarregado, o sistema iniciará a política OverThrottledAc . Observe que o gerenciador de políticas de energia tem uma política embutida em código para iniciar um CriticalShutdownOff sempre que qualquer zona térmica indicar uma condição térmica crítica. Intervalo: 0 a 100.

MinThrottleDc

A configuração mínima de limitação permitida antes de ser superestimada quando o sistema está em execução na energia da bateria. As condições térmicas seriam o único motivo para ficar abaixo da configuração mínima. Quando o processador for sobrecarregado, o sistema iniciará a política OverThrottledDc . Observe que o gerenciador de políticas de energia tem uma política embutida em código para iniciar um CriticalShutdownOff sempre que qualquer zona térmica indicar uma condição térmica crítica. Intervalo: 0 a 100.

pad1[2]

Reservado.

OverThrottledAc

Uma estrutura POWER_ACTION_POLICY que define a ação a ser tomada quando um processador se torna sobrecarregado (conforme definido pelo membro MinThrottleAc ) quando o sistema está em execução na energia AC.

OverThrottledDc

Uma estrutura POWER_ACTION_POLICY que define a ação a ser tomada quando um processador se torna sobrecarregado (conforme definido pelo membro MinThrottleDc ) quando o sistema está em execução na energia da bateria.

Comentários

DozeS4TimeoutAc e DozeS4TimeoutDc correspondem ao membro DozeS4Timeout do SYSTEM_POWER_POLICY. Esses valores são mesclados da política de energia do computador para a política de energia do sistema quando a função SetActivePwrScheme é chamada para aplicar um esquema de energia.

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	powrprof.h

Confira também

POWER_ACTION_POLICY

POWER_POLICY