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

  • Artículo

La rutina de devolución de llamada ComponentCriticalTransitionCallback controla una transición del componente especificado entre el F0 (totalmente activado) y los estados de potencia del componente 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 miembro DeviceContext de la estructura de 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 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 componente 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 baja potencia a F0. Si es FALSE, el componente está a punto de iniciar una transición de F0 a un estado Fx de baja potencia.

Valor devuelto

None

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 una rutina de devolución de llamada ComponentCriticalTransitionCallback . 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 que el componente haya completado 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 que el componente inicie una transición pendiente de F0 a un estado Fx de baja potencia. 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 Fx , vea Administración de energía de nivel de componente.

Requisitos

Requisito Value
Cliente mínimo compatible Se admite a partir de Windows 10.
Plataforma de destino Windows
Encabezado wdm.h (incluya Wudfwdm.h)

Consulte también

PO_FX_CORE_DEVICE