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 |