Función PoFxReportDevicePoweredOn (wdm.h)

  • Artículo

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.
En respuesta a cualquier repetición, el controlador envía D0 IRP (una solicitud de IRP_MN_SET_POWER ) a su pila de dispositivos para iniciar una transición al estado de alimentación D0, si el dispositivo aún no está en estado D0. Una vez completado el controlador (y todos los controladores inferiores) la transición al estado D0, el controlador llama a PoFxReportDevicePoweredOn para notificar a PoFx.

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

Consulte también

DevicePowerRequiredCallback

IRP_MN_SET_POWER

PoFxRegisterDevice