structure PEP_NOTIFY_COMPONENT_IDLE_STATE (pep_x.h)

Article
02/07/2025

La structure PEP_NOTIFY_COMPONENT_IDLE_STATE contient des informations d’état sur la transition en attente d’un composant vers un nouvel état d’alimentation de Fx.

Syntaxe

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;

Membres

[in] DeviceHandle

Valeur PEPHANDLE qui identifie l’appareil. Le PEP a fourni ce handle en réponse à une notification PEP_DPM_REGISTER_DEVICE précédente.

[in] Component

Index qui identifie le composant. Ce membre est un index dans le tableau Components dans la structure PEP_DEVICE_REGISTER_V2 que le PEP a précédemment fourni en réponse à la notification PEP_DPM_REGISTER_DEVICE pour cet appareil. Si le tableau Composants contient N éléments, les index de composant sont comprises entre 0 et N-1.

[in] IdleState

Le nouvel état d’alimentation Fx vers lequel le composant passera. Si ce paramètre est égal à zéro, le nouvel état est F0 ; si ce paramètre est un paramètre, le nouvel état est F1 ; et ainsi de suite.

[in] DriverNotified

Indique si le pilote de l’appareil a déjà été averti de la transition en attente vers le nouvel état Fx. Si la valeur est TRUE, l’infrastructure de gestion de l’alimentation (PoFx) a déjà averti le pilote en appelant la routine de rappel ComponentIdleStateCallback du pilote. Si la valeur est FALSE, PoFx n’a pas encore averti le pilote.

[out] Completed

Indique si le pep a effectué toutes les préparations nécessaires pour que le composant spécifié entre le nouvel état Fx. Définissez la valeur TRUE pour indiquer que le PEP a effectué toutes les préparations nécessaires, ou sur FALSE pour indiquer qu’il n’y a pas.

Si la valeur est FALSE, le PEP doit effectuer les préparations nécessaires ultérieurement, puis informer PoFx lorsque les préparations ont été effectuées. Pour ce faire, le PEP appelle la routine RequestWorker pour demander un élément de travail, puis répond à la notification PEP_DPM_WORK suivante en envoyant une demande de travail de type PepWorkCompleteIdleState pour informer PoFx que les préparations sont terminées.

Remarques

Cette structure est utilisée par la notification PEP_DPM_NOTIFY_COMPONENT_IDLE_STATE. Les quatre premiers membres de cette structure contiennent des valeurs d’entrée fournies par PoFx. Le membre Terminé contient une valeur de sortie que le PEP écrit dans la structure en réponse à cette notification.