Función PoClearPowerRequest (wdm.h)

  • Artículo

La rutina PoClearPowerRequest disminuye el recuento del tipo de solicitud de energía especificado.

Sintaxis

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

Parámetros

[in, out] PowerRequest

Puntero a un objeto de solicitud de energía creado por la rutina PoCreatePowerRequest .

[in] Type

Tipo de la solicitud de energía. Establezca este parámetro en el siguiente valor de enumeración POWER_REQUEST_TYPE :

  • PowerRequestSystemRequired

Valor devuelto

PoClearPowerRequest devuelve STATUS_SUCCESS si la llamada se realiza correctamente. Si se produce un error en la llamada, los posibles códigos de retorno de error incluyen lo siguiente:

Código devuelto Descripción
STATUS_NOT_SUPPORTED
 El tipo de parámetro se establece en un valor no admitido.

Comentarios

Un controlador puede llamar a la rutina PoSetPowerRequest para solicitar que el administrador de energía reemplace varios tipos de comportamiento de energía predeterminado, que se especifican como valores de enumeración POWER_REQUEST_TYPE . Para restaurar el comportamiento predeterminado, el controlador cancela la solicitud llamando a la rutina PoClearPowerRequest .

El administrador de energía mantiene un recuento de las solicitudes activas para cada tipo de solicitud de energía. La rutina PoSetPowerRequest incrementa el recuento del tipo de solicitud de energía especificado en uno. La rutina PoClearPowerRequest disminuye el recuento por uno. Un recuento distinto de cero indica que las solicitudes de uno o varios componentes están activos. Después de que el recuento disminuye en cero, el administrador de energía restaura el comportamiento predeterminado para el tipo de solicitud de energía especificado.

Requisitos

Requisito Value
Cliente mínimo compatible Disponible a partir de Windows 7.
Plataforma de destino Universal
Encabezado wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h)
Library NtosKrnl.lib
Archivo DLL NtosKrnl.exe
IRQL <= DISPATCH_LEVEL

Consulte también

POWER_REQUEST_TYPE

PoCreatePowerRequest

PoSetPowerRequest