estructura de PEP_NOTIFY_COMPONENT_IDLE_STATE (pep_x.h)

Artículo
03/05/2024

La estructura de PEP_NOTIFY_COMPONENT_IDLE_STATE contiene información de estado sobre la transición pendiente de un componente a un nuevo estado de energía Fx .

Sintaxis

typedef struct _PEP_NOTIFY_COMPONENT_IDLE_STATE {
  [in]  PEPHANDLE DeviceHandle;
  [in]  ULONG     Component;
  [in]  ULONG     IdleState;
  [in]  BOOLEAN   DriverNotified;
  [out] BOOLEAN   Completed;
} PEP_NOTIFY_COMPONENT_IDLE_STATE, *PPEP_NOTIFY_COMPONENT_IDLE_STATE;

Miembros

[in] DeviceHandle

Valor PEPHANDLE que identifica el dispositivo. El PEP proporcionó este identificador en respuesta a una notificación de PEP_DPM_REGISTER_DEVICE anterior.

[in] Component

Índice que identifica el componente. Este miembro es un índice en la matriz Components de la estructura PEP_DEVICE_REGISTER_V2 que el PEP proporcionó anteriormente en respuesta a la notificación de PEP_DPM_REGISTER_DEVICE para este dispositivo. Si la matriz Components contiene N elementos, los índices de componente oscilan entre 0 y N-1.

[in] IdleState

El nuevo estado de energía Fx al que pasará el componente. Si este parámetro es cero, el nuevo estado es F0; si este parámetro es uno, el nuevo estado es F1; y así sucesivamente.

[in] DriverNotified

Indica si el controlador del dispositivo ya se ha notificado de la transición pendiente al nuevo estado Fx . Si es TRUE, el marco de administración de energía (PoFx) ya ha notificado al controlador mediante una llamada a la rutina de devolución de llamada ComponentIdleStateCallback del controlador. Si es FALSE, PoFx aún no ha notificado al controlador.

[out] Completed

Si el PEP ha completado todos los preparativos necesarios para que el componente especificado entre el nuevo estado Fx . Establézcalo en TRUE para indicar que el PEP ha completado todos los preparativos necesarios o en FALSE para indicar que no lo ha hecho.

Si es FALSE, el PEP debe completar los preparativos necesarios en un momento posterior y, a continuación, informar a PoFx cuando se hayan completado los preparativos. Para ello, el PEP llama a la rutina RequestWorker para solicitar un elemento de trabajo y, a continuación, responde a la siguiente notificación PEP_DPM_WORK enviando una solicitud de trabajo de tipo PepWorkCompleteIdleState para informar a PoFx de que los preparativos están completos.

Comentarios

La notificación de PEP_DPM_NOTIFY_COMPONENT_IDLE_STATE usa esta estructura. Los cuatro primeros miembros de esta estructura contienen valores de entrada proporcionados por PoFx. El miembro Completed contiene un valor de salida que el PEP escribe en la estructura en respuesta a esta notificación.