Função PowerSetRequest (winbase.h)

  • Artigo

Incrementa a contagem de solicitações de energia do tipo especificado para um objeto de solicitação de energia.

Sintaxe

BOOL PowerSetRequest(
  [in] HANDLE             PowerRequest,
  [in] POWER_REQUEST_TYPE RequestType
);

Parâmetros

[in] PowerRequest

Um identificador para um objeto de solicitação de energia.

[in] RequestType

O tipo de solicitação de energia a ser incrementado. Esse parâmetro pode usar um dos valores a seguir.

Valor Descrição
PowerRequestDisplayRequired A exibição permanecerá ativada mesmo que não haja nenhuma entrada do usuário por um longo período de tempo.

Nota: Um PowerRequestSystemRequired deve ser usado além de um PowerRequestDisplayRequired para garantir que a exibição permaneça ativada e que o sistema não entre em suspensão durante a solicitação.
PowerRequestSystemRequired O sistema continua a ser executado em vez de entrar em suspensão após um período de inatividade do usuário.
PowerRequestAwayModeRequired O sistema entra no modo de suspensão em vez de suspensão em resposta à ação explícita do usuário. No modo ausente, o sistema continua a ser executado, mas desativa o áudio e o vídeo para dar a aparência de suspensão. PowerRequestAwayModeRequired só é aplicável em sistemas de Suspensão Tradicional (S3).
PowerRequestExecutionRequired O processo de chamada continua sendo executado em vez de ser suspenso ou encerrado por mecanismos de gerenciamento de tempo de vida do processo. Quando e por quanto tempo o processo tem permissão para ser executado depende das configurações do sistema operacional e da política de energia.

Em sistemas de Suspensão Tradicional (S3), uma solicitação Ativa do PowerRequestExecutionRequired implica Em PowerRequestSystemRequired.

Valor retornado

Se a função for bem-sucedida, ela retornará um valor diferente de zero.

Se a função falhar, ela retornará zero. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Em sistemas de espera modernos na energia dc, as solicitações de energia necessárias para o sistema e a execução são encerradas 5 minutos após o tempo limite de suspensão do sistema expirar.

Exceto para PowerRequestAwayModeRequired em sistemas S3 (Suspensão Tradicional), as solicitações de energia são encerradas após a entrada de suspensão do sistema iniciada pelo usuário (botão ligar/desligar, fechar a tampa ou selecionar Suspender no menu Iniciar ).

Para economizar energia e fornecer a melhor experiência do usuário, os aplicativos que usam solicitações de energia devem seguir estas práticas recomendadas:

  • Ao criar uma solicitação de energia, forneça uma cadeia de caracteres de texto localizada que descreva o motivo da solicitação na estrutura REASON_CONTEXT .
  • Chame PowerSetRequest imediatamente antes do cenário que requer a solicitação.
  • Chame PowerClearRequest para diminuir a contagem de referência para a solicitação assim que o cenário for concluído.
  • Limpe todos os objetos de solicitação e identificadores associados antes que o processo seja encerrado ou o serviço pare.

Requisitos

   
Cliente mínimo com suporte Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho winbase.h (incluir Windows.h)
Biblioteca Kernel32.lib
DLL Kernel32.dll

Confira também

PowerClearRequest

PowerCreateRequest