Função PowerSetRequest (winbase.h)
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 |