PO_FX_COMPONENT_CRITICAL_TRANSITION_CALLBACK función de devolución de llamada (wdm.h)
La rutina de devolución de llamada ComponentCriticalTransitionCall back controla una transición del componente especificado entre los estados de potencia F0 (totalmente activado) y Fx de bajo consumo.
Sintaxis
PO_FX_COMPONENT_CRITICAL_TRANSITION_CALLBACK PoFxComponentCriticalTransitionCallback;
void PoFxComponentCriticalTransitionCallback(
[in] PVOID Context,
[in] ULONG Component,
[in] BOOLEAN Active
)
{...}
Parámetros
[in] Context
Puntero al contexto del dispositivo. El controlador de dispositivo usa este contexto para almacenar información sobre el estado de energía actual del dispositivo. Este contexto está definido por el controlador y es opaco para PoFx. El controlador especificó este puntero en el elemento DeviceContext de la estructura PO_FX_CORE_DEVICE que el controlador usó para registrar el dispositivo con el marco de administración de energía de Windows (PoFx).
[in] Component
Índice que identifica el componente. Este parámetro es un índice en la matriz de Components de la estructura PO_FX_CORE_DEVICE que el controlador de dispositivo usó para registrar el dispositivo con PoFx. Si la matriz Components contiene N elementos, los índices de componentes van de 0 a N-1.
[in] Active
Indica si esta notificación es para una transición al estado de energía del componente F0. Si es TRUE, el componente acaba de completar una transición de un estado Fx de bajo consumo a F0. Si es FALSE, el componente está a punto de iniciar una transición de F0 a un estado dex de bajo consumo.
Valor devuelto
Ninguno
Observaciones
PoFx implementa esta rutina de devolución de llamada. PoFx llama a esta rutina para notificar al controlador las transiciones de energía de los componentes del dispositivo.
El miembro ComponentCriticalTransitionCallback de la estructura PO_FX_CORE_DEVICE es un puntero a un ComponentCriticalTransitionCallback rutina de devolución de llamada. Un puntero a una estructura de PO_FX_CORE_DEVICE se pasa como parámetro de entrada en la llamada PoFxRegisterCoreDevice que registra un dispositivo principal con el marco de administración de energía de Windows (PoFx).
Para controlar las llamadas a esta rutina, el controlador de dispositivo guarda o restaura el estado de registro u otro contexto de hardware del componente especificado en el dispositivo.
Si Active = TRUE, PoFx ha llamado a esta rutina después de el componente completó una transición de un estado Fx de baja potencia a F0. En esta llamada, la rutina restaura el contexto de hardware guardado anteriormente del componente.
Si Active = FALSE, PoFx ha llamado a esta rutina antes de el componente inicia una transición pendiente de F0 a un estado de Fx de bajo consumo. En esta llamada, la rutina guarda el contexto de hardware del componente para que este contexto se pueda restaurar más adelante.
Para obtener más información sobre los estados de energía de componentes deX F, consulte Component-Level Power Management.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Se admite a partir de Windows 10. |
| de la plataforma de destino de | Windows |
| encabezado de | wdm.h (incluya Wudfwdm.h) |