Função PoSetPowerRequest (ntifs.h)
A rotina PoSetPowerRequest incrementa a contagem do tipo de solicitação de energia especificado.
Sintaxe
NTSTATUS PoSetPowerRequest(
[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 rotinaPoCreatePowerRequest.
[in] Type
O tipo de solicitação de energia. Defina esse parâmetro para o seguinte valor de enumeração POWER_REQUEST_TYPE:
- PowerRequestSystemRequired
Valor de retorno
PoSetPowerRequest retornará STATUS_SUCCESS se a chamada for bem-sucedida. Se a chamada falhar, 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. |
Observações
Um driver pode chamar a rotina PoSetPowerRequest para solicitar que o power manager substituir 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 rotinaPoClearPowerRequest.
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 do tipo de solicitação de energia especificado por um. O PoClearPowerRequest diminui a contagem por 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 computador reverte para o comportamento padrão do tipo de solicitação de energia especificado.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows 7 |
| da Plataforma de Destino | Universal |
| cabeçalho | ntifs.h (incluem Wdm.h, Ntddk.h, Ntifs.h) |
| biblioteca | NtosKrnl.lib |
| de DLL | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL |