Función PoFxStartDevicePowerManagement (wdm.h)
La rutina PoFxStartDevicePowerManagement completa el registro de un dispositivo con el marco de administración de energía (PoFx) e inicia la administración de energía del dispositivo.
Sintaxis
void PoFxStartDevicePowerManagement(
[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ó previamente este identificador de la rutina PoFxRegisterDevice .
Valor devuelto
None
Observaciones
Después de que un controlador llame a la rutina PoFxRegisterDevice para registrar un dispositivo con PoFx, todos los componentes del dispositivo están totalmente activados y en la condición activa para que el controlador pueda terminar de inicializar el hardware. Para iniciar la administración de energía activa, el controlador debe llamar a PoFxStartDevicePowerManagement. De forma predeterminada, esta llamada cambia todos los componentes a la condición de inactividad.
Después de que PoFxStartDevicePowerManagement cambie un componente a la condición inactiva, PoFx podría empezar a llamar inmediatamente a las rutinas de devolución de llamada del controlador, incluso antes de que PoFxStartDevicePowerManagement devuelva. PoFx llama a la rutina de devolución de llamada ComponentIdleConditionCallback del controlador para indicar que un componente ha cambiado a la condición de inactividad. El controlador no debe tener acceso a un componente que esté en la condición de inactividad. Para que el controlador pueda acceder al componente, el controlador debe llamar a PoFxActivateComponent y esperar a que PoFx llame a la rutina de devolución de llamada ComponentActiveConditionCallback del controlador. Esta devolución de llamada informa al controlador de que el componente está en la condición activa y a la que se puede acceder de forma segura.
Si el controlador requiere que un componente esté en la condición activa inmediatamente después de que se inicie la administración de energía, el controlador debe activar explícitamente el componente llamando a la rutina PoFxActivateComponent y esta llamada debe producirse después de la llamada a PoFxRegisterDevice , pero antes de la llamada a PoFxStartDevicePowerManagement .
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 | PASSIVE_LEVEL |
Consulte también
ComponentActiveConditionCallback