Función PoSetPowerRequest (ntifs.h)
La rutina PoSetPowerRequest incrementa el recuento del tipo de solicitud de energía especificado.
Sintaxis
NTSTATUS PoSetPowerRequest(
[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 solicitud de energía. Establezca este parámetro en el siguiente valor de enumeración POWER_REQUEST_TYPE:
- PowerRequestSystemRequired
Valor devuelto
PoSetPowerRequest 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 parámetro Type se establece en un valor no admitido. |
Comentarios
Un controlador puede llamar a la rutina PoSetPowerRequest para solicitar que el administrador de energía invalide varios tipos de comportamiento de energía predeterminado, que se especifican como POWER_REQUEST_TYPE valores de enumeración. 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 activas. Después de que el recuento disminuye en cero, el equipo vuelve al comportamiento predeterminado del tipo de solicitud de energía especificado.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 7 |
| Plataforma de destino | Universal |
| Encabezado | ntifs.h (incluye Wdm.h, Ntddk.h, Ntifs.h) |
| Library | NtosKrnl.lib |
| Archivo DLL | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL |