Función PoFxReportDevicePoweredOn (wdm.h)
La rutina PoFxReportDevicePoweredOn notifica al marco de administración de energía (PoFx) que el dispositivo completó la transición solicitada al estado de alimentación D0 (totalmente activado).
Sintaxis
void PoFxReportDevicePoweredOn(
[in] POHANDLE Handle
);
Parámetros
[in] Handle
Identificador que representa el registro del dispositivo con el marco de administración de energía (PoFx). El controlador de dispositivo recibió anteriormente este identificador de la rutina PoFxRegisterDevice .
Valor devuelto
None
Observaciones
El controlador de un dispositivo registrado debe llamar a PoFxReportDevicePoweredOn después de cualquiera de las siguientes repeticiones:
- PoFx llama a la rutina de devolución de llamada DevicePowerRequiredCallback del controlador para notificar al controlador que el dispositivo debe entrar en el estado de alimentación D0.
- PoFx llama a la rutina de devolución de llamada DirectedPowerUpCallback del controlador para notificar al controlador que el dispositivo debe entrar en el estado de alimentación D0.
- PoFx envía al controlador un IRP S0 (una solicitud de IRP_MN_SET_POWER ) para notificar al controlador una transición del sistema pendiente al estado de alimentación S0.
El controlador debe llamar a PoFxReportDevicePoweredOn independientemente de si no se requiere irP D0, se produce un error en la solicitud irP D0, el IRP enviado se realiza correctamente o se produce un error, o el IRP S0 se realiza correctamente o se produce un error.
Para la devolución de llamada de alimentación requerida o dirigida, la llamada a PoFxReportDevicePoweredOn puede producirse durante o después de la llamada de devolución de llamada.
Para una solicitud IRP de S0, el controlador debe completar esta solicitud lo antes posible, cambiar el dispositivo al estado de alimentación D0 y llamar a PoFxReportDevicePoweredOn. Para obtener más información, consulte Control de un IRP del sistema Set-Power en un propietario de la directiva de energía del dispositivo.
Al entrar a PoFxReportDevicePoweredOn, el dispositivo podría estar en un estado de alimentación D0 sin inicializar en el que todos los componentes del dispositivo están activados. En respuesta a la llamada a PoFxReportDevicePoweredOn , PoFx configura el dispositivo en un estado D0 inicializado. Durante esta configuración, PoFx cambia tantos componentes como pueda a estados de energía fx de bajo consumo.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible a partir de Windows 8. |
| Plataforma de destino | Universal |
| Encabezado | wdm.h |
| Library | Ntoskrnl.lib |
| Archivo DLL | Ntoskrnl.exe |
| IRQL | <= DISPATCH_LEVEL |