structure PEP_NOTIFY_COMPONENT_IDLE_STATE (pepfx.h)

Article
02/26/2024

La structure PEP_NOTIFY_COMPONENT_IDLE_STATE contient status informations sur la transition en attente d’un composant vers un nouvel état d’alimentation 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 Composants de la structure PEP_DEVICE_REGISTER_V2 que le PEP a fourni précédemment en réponse à la notification PEP_DPM_REGISTER_DEVICE pour cet appareil. Si le tableau Composants contient N éléments, les index des composants vont de 0 à N–1.

[in] IdleState

Nouvel état d’alimentation Fx vers lequel le composant effectuera la transition. Si ce paramètre est zéro, le nouvel état est F0 ; si ce paramètre est un, le nouvel état est F1 ; et ainsi de suite.

[in] DriverNotified

Indique si le pilote de l’appareil a déjà été informé 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 terminé toutes les préparations nécessaires pour que le composant spécifié entre le nouvel état Fx . Définissez sur TRUE pour indiquer que le PEP a terminé toutes les préparations nécessaires, ou sur FALSE pour indiquer que n’a pas.

Si la valeur est FALSE, le PEP doit effectuer les préparations nécessaires ultérieurement, puis informer PoFx de la fin des préparatifs. Pour ce faire, le PEP appelle la routine RequestWorker pour demander un élément de travail, puis répond à la notification PEP_DPM_WORK qui suit en soumettant 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.