enumeração POWER_REQUEST_TYPE (ntpoapi.h)

  • Artigo

A enumeração POWER_REQUEST_TYPE indica o tipo de solicitação de energia.

Syntax

typedef enum _POWER_REQUEST_TYPE {
  PowerRequestDisplayRequired,
  PowerRequestSystemRequired,
  PowerRequestAwayModeRequired,
  PowerRequestExecutionRequired
} POWER_REQUEST_TYPE, *PPOWER_REQUEST_TYPE;

Constantes

 
PowerRequestDisplayRequired
Não usado por drivers. Para obter mais informações, consulte Comentários.
PowerRequestSystemRequired
Impede que o computador entre automaticamente no modo de suspensão após um período de inatividade do usuário.
PowerRequestAwayModeRequired
Não usado por drivers. Para obter mais informações, consulte Comentários.
PowerRequestExecutionRequired
Não usado por drivers. Para obter mais informações, consulte Comentários.

Comentários

Essa enumeração é usada pelas rotinas PoClearPowerRequest e PoSetPowerRequest no modo kernel. Os drivers que chamam essas rotinas devem especificar o valor de enumeração PowerRequestSystemRequired .

Os outros três valores de enumeração — PowerRequestDisplayRequired, PowerRequestAwayModeRequired e PowerRequestExecutionRequired — não são usados por drivers. Os aplicativos especificam esses tipos de solicitação de energia em chamadas para as funções PowerSetRequest e PowerClearRequest .

Uma solicitação de energia PowerRequestDisplayRequired tem os seguintes efeitos:

  • Após um período de inatividade do usuário, a exibição da sessão permanece ativada e não será desativada automaticamente. Se a exibição já estiver desativada, a solicitação de energia ativa a exibição.
  • Um protetor de tela não será iniciado automaticamente após um período de inatividade do usuário. Se um protetor de tela já estiver em execução, a solicitação de energia interromperá o protetor de tela.
  • A sessão não será bloqueada automaticamente após um período de inatividade do usuário. Se a sessão já estiver bloqueada quando o driver enviar a solicitação de energia, a sessão permanecerá bloqueada.
Enquanto uma solicitação de energia PowerRequestAwayModeRequired está em vigor, se o usuário tentar colocar o computador no modo de suspensão (por exemplo, clicando em Iniciar e, em seguida, clicando em Suspensão), o power manager desativa o áudio e o vídeo para que o computador pareça estar no modo de suspensão, mas o computador continue a ser executado.

Enquanto uma solicitação de energia PowerRequestExecutionRequired está em vigor, o processo de chamada continua a ser executado em vez de ser suspenso ou encerrado por mecanismos plm (gerenciamento de tempo de vida do processo). Quando e quanto tempo o processo tem permissão para ser executado depende das configurações do sistema operacional e da política de energia. Esse tipo de solicitação de energia tem suporte começando com Windows 8.

Requisitos

Requisito Valor
Cliente mínimo com suporte Com suporte a partir do Windows 7.
Cabeçalho ntpoapi.h (include Wdm.h, Ntddk.h, Ntifs.h, Ntpoapi.h)

Confira também

PoClearPowerRequest

PoSetPowerRequest

PowerClearRequest

PowerSetRequest