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

  • Artículo

El controlador de 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 (Directed 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

None

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, a continuación, 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 de PO_FX_DIRECTED_POWER_DOWN_CALLBACK . Es posible que el dispositivo deba encenderse cuando el sistema salga del modo de espera moderno, los activadores empiecen 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 completa la llamada de encendido dirigido, 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 alimentación dirigido pide a los dispositivos secundarios que se apaguen antes del dispositivo primario. En el caso de un dispositivo primario determinado, se tienen en cuenta los elementos secundarios directos (los enumerados por el elemento primario) y los secundarios indirectos debido a las relaciones de potencia .

Requisitos

Requisito Value
Cliente mínimo compatible Windows 10, versión 1903
Encabezado wdm.h (incluya Wdm.h)

Consulte también

Introducción al Marco de administración de energía dirigida

PO_FX_DIRECTED_POWER_DOWN_CALLBACK