estrutura USER_POWER_POLICY (powrprof.h)
Contém configurações de política de energia exclusivas para cada esquema de energia para um usuário. Essa estrutura faz parte da estrutura POWER_POLICY .
Sintaxe
typedef struct _USER_POWER_POLICY {
ULONG Revision;
POWER_ACTION_POLICY IdleAc;
POWER_ACTION_POLICY IdleDc;
ULONG IdleTimeoutAc;
ULONG IdleTimeoutDc;
UCHAR IdleSensitivityAc;
UCHAR IdleSensitivityDc;
UCHAR ThrottlePolicyAc;
UCHAR ThrottlePolicyDc;
SYSTEM_POWER_STATE MaxSleepAc;
SYSTEM_POWER_STATE MaxSleepDc;
ULONG Reserved[2];
ULONG VideoTimeoutAc;
ULONG VideoTimeoutDc;
ULONG SpindownTimeoutAc;
ULONG SpindownTimeoutDc;
BOOLEAN OptimizeForPowerAc;
BOOLEAN OptimizeForPowerDc;
UCHAR FanThrottleToleranceAc;
UCHAR FanThrottleToleranceDc;
UCHAR ForcedThrottleAc;
UCHAR ForcedThrottleDc;
} USER_POWER_POLICY, *PUSER_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 USER_POWER_POLICY para definir a política de energia.
IdleAc
Uma estrutura POWER_ACTION_POLICY que define a ação de energia do sistema a ser iniciada quando o sistema está em execução na energia AC (utilitário) e o temporizador ocioso do sistema expira.
IdleDc
Uma estrutura POWER_ACTION_POLICY que define a ação de energia do sistema a ser iniciada quando o sistema está em execução na energia da bateria e o temporizador ocioso do sistema expira.
IdleTimeoutAc
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 ao ser executado na energia ac (utilitário), em segundos.
Esse membro será ignorado se o sistema estiver executando um currículo automatizado porque não há nenhum usuário presente. Para manter temporariamente o sistema em execução enquanto um aplicativo está executando uma tarefa, use a função SetThreadExecutionState .
IdleTimeoutDc
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 ao ser executado na energia da bateria, em segundos.
Esse membro será ignorado se o sistema estiver executando um currículo automatizado porque não há nenhum usuário presente. Para manter temporariamente o sistema em execução enquanto um aplicativo está executando uma tarefa, use a função SetThreadExecutionState .
IdleSensitivityAc
O nível de atividade do sistema que define o limite para detecção ociosa quando o sistema está em execução na energia AC (utilitário), expresso como uma porcentagem.
IdleSensitivityDc
O nível de atividade do sistema que define o limite para detecção ociosa quando o sistema está em execução na energia da bateria, expresso como uma porcentagem.
ThrottlePolicyAc
A política de limitação dinâmica do processador a ser usada quando o sistema estiver em execução na energia AC (utilitário).
ThrottlePolicyDc
A política de limitação dinâmica do processador a ser usada quando o sistema estiver em execução na energia da bateria.
MaxSleepAc
O estado máximo de suspensão do sistema quando o sistema está em execução na energia AC (utilitário). Esse membro deve ser um dos valores de tipo de enumeração SYSTEM_POWER_STATE.
MaxSleepDc
O estado máximo de suspensão do sistema quando o sistema está em execução com a energia da bateria. Esse membro deve ser um dos valores de tipo de enumeração SYSTEM_POWER_STATE.
Reserved[2]
Reservado.
VideoTimeoutAc
O tempo antes de a exibição ser desativada quando o sistema estiver em execução na energia AC (utilitário), em segundos.
VideoTimeoutDc
O tempo antes da exibição ser desativada quando o sistema estiver em execução com a energia da bateria, em segundos.
SpindownTimeoutAc
O tempo antes da energia para unidades de disco fixas é desativado quando o sistema está em execução na energia AC (utilitário), em segundos.
SpindownTimeoutDc
O tempo antes da energia para unidades de disco fixas é desativado quando o sistema está em execução com a energia da bateria, em segundos.
OptimizeForPowerAc
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 e o sistema estiver em execução na energia AC (utilitário). Isso faz com que o sistema operacional seja tendencioso em relação ao uso do ventilador e à execução do processador a toda velocidade.
OptimizeForPowerDc
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 e o sistema estiver em execução com a energia da bateria. Isso faz com que o sistema operacional seja tendencioso em relação ao uso do ventilador e à execução do processador a toda velocidade.
FanThrottleToleranceAc
O limite inferior ao qual o processador pode ser limitado antes de ativar os ventiladores do sistema em resposta a um evento térmico enquanto o sistema está operando com a energia AC (utilitário), expresso como uma porcentagem.
FanThrottleToleranceDc
O limite inferior ao qual o processador pode ser limitado antes de ativar os ventiladores do sistema em resposta a um evento térmico enquanto o sistema está operando com a energia da bateria, expresso como uma porcentagem.
ForcedThrottleAc
O nível de aceleração do processador a ser imposto pelo sistema enquanto o computador está em execução na energia AC (utilitário), expresso como uma porcentagem.
ForcedThrottleDc
O nível de aceleração do processador a ser imposto pelo sistema enquanto o computador está em execução na energia da bateria, expresso como uma porcentagem.
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 |