Função PoClearPowerRequest (wdm.h)
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 |
|---|---|
|
O Tipo de Parâmetro é 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 POWER_REQUEST_TYPE valores de enumeração. 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 em 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 | Disponível a partir do Windows 7. |
| Plataforma de Destino | Universal |
| Cabeçalho | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| Biblioteca | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL |