structure PEP_PPM_IDLE_SELECT (pep_x.h)

Article
02/29/2024

La structure PEP_PPM_IDLE_SELECT décrit l’état d’inactivité le plus économe en énergie que le processeur peut entrer et toujours satisfaire aux contraintes spécifiées par le système d’exploitation.

Syntaxe

typedef struct _PEP_PPM_IDLE_SELECT {
  [in]  PPEP_PROCESSOR_IDLE_CONSTRAINTS Constraints;
  [out] BOOLEAN                         AbortTransition;
  [out] ULONG                           IdleStateIndex;
  [out] ULONG                           DependencyArrayUsed;
  [in]  ULONG                           DependencyArrayCount;
  [in]  PPEP_PROCESSOR_IDLE_DEPENDENCY  DependencyArray;
  [out] ULONG                           PlatformIdleStateIndex;
} PEP_PPM_IDLE_SELECT, *PPEP_PPM_IDLE_SELECT;

Membres

[in] Constraints

Pointeur vers une structure de PEP_PROCESSOR_IDLE_CONSTRAINTS qui spécifie les contraintes auxquelles l’état d’inactivité du processeur sélectionné doit satisfaire. Le système d’exploitation définit les valeurs dans cette structure. Le plug-in d’extension de plateforme (PEP) doit sélectionner un état d’inactivité du processeur qui répond à ces contraintes.

[out] AbortTransition

S’il faut annuler la transition en attente vers un état d’inactivité du processeur. Définissez ce membre sur TRUE si le PEP exige que le système d’exploitation annule la transition en attente, et sur FALSE dans le cas contraire. Le PEP sélectionne cette option s’il souhaite mettre en file d’attente le travail et que le noyau Windows traite ce travail avant que le processeur ne soit inactif.

[out] IdleStateIndex

Index qui identifie l’état inactif que le processeur doit entrer. Ce membre est ignoré si AbortTransition = TRUE. Si le processeur prend en charge N états inactifs, les index d’état d’inactivité vont de 0 à N–1. Le PEP a fourni le nombre d’états inactifs pris en charge pour ce processeur en réponse à une notification PEP_NOTIFY_PPM_QUERY_IDLE_STATES précédente.

[out] DependencyArrayUsed

Nombre d’éléments de tableau que le PEP a effectivement écrits dans la mémoire tampon de sortie pointée vers le membre DependencyArray .

[in] DependencyArrayCount

Nombre maximal d’éléments dans le tableau pointé vers le membre DependencyArray . La valeur du membre DependencyArrayCount est égale à la valeur MaximumCo coordonnéesProcessors fournie précédemment par le PEP en réponse à la notification PEP_NOTIFY_PPM_QUERY_IDLE_STATES .

[in] DependencyArray

Pointeur vers une mémoire tampon de sortie dans laquelle le PEP écrit un tableau de structures PEP_PROCESSOR_IDLE_DEPENDENCY . Les éléments de ce tableau spécifient les dépendances inactives du processeur ou les dépendances de veille qui doivent être remplies pour que cette transition inactive réussisse. Le PEP définit le membre DependencyArrayUsed sur le nombre réel d’éléments de tableau que le PEP écrit dans la mémoire tampon. La mémoire tampon de sortie est allouée par l’infrastructure de gestion de l’alimentation Windows (PoFx) et est garantie d’être suffisamment grande pour contenir le nombre d’éléments de tableau spécifié par le membre DependencyArrayCount .

[out] PlatformIdleStateIndex

Index de l’état d’inactivité de la plateforme que la plateforme doit entrer lorsque le processeur entre dans l’état d’inactivité du processeur sélectionné. Le PEP doit définir ce membre uniquement si la plateforme entre dans un état inactif en même temps que le processeur. Ce membre est ignoré si AbortTransition a la valeur TRUE.

Remarques

Cette structure est utilisée par la notification PEP_NOTIFY_PPM_IDLE_SELECT . Les membres Contraintes, DependencyArrayCount et DependencyArray de la structure contiennent des valeurs d’entrée fournies par PoFx lors de l’envoi de cette notification. Les membres restants contiennent des valeurs de sortie que le PEP écrit dans la structure en réponse à la notification.