Função PoClearPowerRequest (ntifs.h)

  • Artigo

A rotina PoClearPowerRequest diminui a contagem para o tipo de solicitação de energia especificado.

Sintaxe

NTSTATUS PoClearPowerRequest(
  [in, out] PVOID              PowerRequest,
  [in]      POWER_REQUEST_TYPE Type
);

Parâmetros

[in, out] PowerRequest

Um ponteiro para um objeto de solicitação de energia que foi criado pela rotina PoCreatePowerRequest .

[in] Type

O tipo da solicitação de energia. Defina esse parâmetro como o seguinte POWER_REQUEST_TYPE valor de enumeração:

  • PowerRequestSystemRequired

Retornar valor

PoClearPowerRequest retornará STATUS_SUCCESS se a chamada for bem-sucedida. Se a chamada falhar, os possíveis códigos de retorno de erro incluem o seguinte:

Código de retorno Descrição
STATUS_NOT_SUPPORTED O parâmetro Type é definido como um valor sem suporte.

Comentários

Um driver pode chamar a rotina PoSetPowerRequest para solicitar que o power manager substitua vários tipos de comportamento de energia padrão, que são especificados como valores de enumeração POWER_REQUEST_TYPE . Para restaurar o comportamento padrão, o driver cancela a solicitação chamando a rotina PoClearPowerRequest .

O power manager mantém uma contagem das solicitações ativas para cada tipo de solicitação de energia. A rotina PoSetPowerRequest incrementa a contagem para o tipo de solicitação de energia especificado por um. A rotina PoClearPowerRequest diminui a contagem em um. Uma contagem diferente de zero indica que as solicitações de um ou mais componentes estão ativas. Depois que a contagem diminui para zero, o power manager restaura o comportamento padrão para o tipo de solicitação de energia especificado.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 7
Plataforma de Destino Universal
Cabeçalho ntifs.h (inclui Wdm.h, Ntddk.h, Ntifs.h)
Biblioteca NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= DISPATCH_LEVEL

Confira também

POWER_REQUEST_TYPE

PoCreatePowerRequest

PoSetPowerRequest