PO_FX_DIRECTED_POWER_DOWN_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_DOWN_CALLBACK para controlar las actividades de apagado específicas del controlador en nombre de DFx (Dirigido PoFx).
Sintaxis
PO_FX_DIRECTED_POWER_DOWN_CALLBACK PoFxDirectedPowerDownCallback;
void PoFxDirectedPowerDownCallback(
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 durante una sesión moderna en espera cuando este dispositivo o un dependiente de este dispositivo ha bloqueado la entrada DRIPS durante al menos dos minutos consecutivos (tiempo de espera configurable por el controlador, 2 minutos predeterminado) sin ninguna actividad de software asincrónica que se ejecute.
Cuando se invoca esta devolución de llamada, el controlador normalmente realiza las siguientes tareas de alto nivel:
Detenga el procesamiento del nuevo trabajo.
Transición al estado de baja potencia inmediatamente.
Permanezca en estado de baja potencia hasta que el sistema llame al PO_FX_DIRECTED_POWER_UP_CALLBACK del controlador.
Los pasos y el orden de implementación pueden variar, pero pueden incluir algunos de los siguientes:
Solicite un IRP dx.
Después de que llegue dx IRP, bloquee las colas de E/S.
Espere a que se completen las operaciones en curso.
Si esas operaciones tardan demasiado tiempo, puede cancelarlas opcionalmente.
Realice las acciones necesarias para realizar la transición del dispositivo a Dx (por ejemplo, guarde el estado de hardware).
Brazo para reactivación según sea necesario.
Llame a PoFxCompleteDirectedPowerDown.
Permanezca en Dx hasta que el sistema llame a PO_FX_DIRECTED_POWER_UP_CALLBACK.
El contrato es muy similar a S3/S4, aunque no hay ningún IRP implicado.
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) |