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

ComponentIdleConditionCallback

PoFxActivateComponent

PoFxRegisterDevice