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
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 durante una sesión en espera moderna 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 que se ejecute ninguna actividad de software asincrónica activadora.
Cuando se invoca esta devolución de llamada, el controlador normalmente realiza las siguientes tareas de alto nivel:
Detenga el procesamiento del nuevo trabajo.
Realice la 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_CALLBACKdel controlador.
Los pasos de implementación y el orden 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 intervienen S-IRP.
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) |