estrutura USER_POWER_POLICY (powrprof.h)

Artigo
03/01/2024

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.

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

Confira também

POWER_ACTION_POLICY

POWER_POLICY

Compartilhar via