Compartir a través de


PO_FX_DIRECTED_POWER_UP_CALLBACK función de devolución de llamada (wdm.h)

El controlador cliente implementa la función de devolución de llamada PO_FX_DIRECTED_POWER_UP_CALLBACK para controlar las actividades de encendido específicas del controlador en nombre de DFx (Dirigido PoFx).

Sintaxis

PO_FX_DIRECTED_POWER_UP_CALLBACK PoFxDirectedPowerUpCallback;

void PoFxDirectedPowerUpCallback(
  PVOID Context,
  ULONG Flags
)
{...}

Parámetros

Context

Proporciona un puntero al contexto pasado a PoFxRegisterDevice.

Flags

Reservado para uso futuro.

Valor devuelto

Ninguno

Observaciones

Los controladores WDM que se registran con PoFx para la compatibilidad con la administración de energía inactiva en tiempo de ejecución deben implementar esta devolución de llamada para agregar compatibilidad con DFx.

Registre la implementación de esta función de devolución de llamada estableciendo el miembro adecuado de la estructura de PO_FX_DEVICE_V3 y llamando a PoFxRegisterDevice.

Esta devolución de llamada se invoca cuando el sistema determina que el dispositivo debe encenderse después de haber apagado previamente en la función de devolución de llamada PO_FX_DIRECTED_POWER_DOWN_CALLBACK. Es posible que el dispositivo tenga que encenderse cuando el sistema salga del modo de espera moderno, activadores empezar a ejecutarse o se produzca una reactivación iniciada por hardware.

Cuando se invoca esta devolución de llamada, el controlador normalmente realiza las siguientes tareas de alto nivel:

  • Solicite un IRP D0 para encender el dispositivo.

  • Una vez completado el IRP D0, llame a PoFxReportDevicePoweredOn.

  • Desbloquee las colas de E/S e inicie el procesamiento de solicitudes normalmente.

Una vez que el controlador complete la llamada de encendido dirigida, puede reanudar el comportamiento de inactividad en tiempo de ejecución (RTD3).

El contrato es muy similar a S0, aunque no hay IRP implicados.

Tenga en cuenta que si una jerarquía de dispositivos está implicada, el marco de trabajo de energía dirigido pide a los dispositivos secundarios que apaguen antes del dispositivo primario. Para un dispositivo primario determinado, se tienen en cuenta los elementos secundarios directos (los enumerados por el elemento primario) y los secundarios indirectos debido a relaciones de potencia.

Requisitos

Requisito Valor
cliente mínimo admitido Windows 10, versión 1903
encabezado de wdm.h (incluya Wdm.h)

Consulte también

Introducción al marco de administración de energía dirigido

PO_FX_DIRECTED_POWER_DOWN_CALLBACK