PEP_PLATFORM_IDLE_STATE structure (pepfx.h)

  • Article

La structure PEP_PLATFORM_IDLE_STATE spécifie les propriétés d’un état d’inactivité de la plateforme.

Syntaxe

typedef struct _PEP_PLATFORM_IDLE_STATE {
  POHANDLE                      InitiatingProcessor;
  UCHAR                         InitiatingState;
  ULONG                         Latency;
  ULONG                         BreakEvenDuration;
  ULONG                         DependencyArrayUsed;
  ULONG                         DependencyArrayCount;
  PEP_PROCESSOR_IDLE_DEPENDENCY DependencyArray[ANYSIZE_ARRAY];
} PEP_PLATFORM_IDLE_STATE, *PPEP_PLATFORM_IDLE_STATE;

Membres

InitiatingProcessor

Valeur POHANDLE qui identifie le processeur qui lance la transition vers cet état d’inactivité de la plateforme, ou NULL si un processeur peut lancer la transition. S’il n’est pas NULL, ce handle représente l’inscription du processeur (en tant qu’appareil) auprès de l’infrastructure de gestion de l’alimentation Windows (PoFx).

InitiatingState

Index de l’état d’inactivité du processeur que le processeur entre pour lancer l’entrée de la plateforme à l’état d’inactivité de la plateforme spécifié. Si le tableau IdleStates dans la structure PEP_PPM_QUERY_IDLE_STATES_V2 contient N éléments, les états inactifs sont numérotés de 0 à N-1 dans l’ordre dans lequel ils apparaissent dans le tableau.

Latency

Latence la plus grave, en unités de 100 nanosecondes, dont la plateforme a besoin pour sortir de cet état d’inactivité en réponse à un événement de veille.

BreakEvenDuration

Durée minimale, spécifiée en unités de 100 nanosecondes, que la plateforme doit passer dans cet état inactif pour effectuer une transition vers cet état qui en vaut la peine. PoFx utilise cette valeur de membre comme indicateur pour éviter de basculer la plateforme vers un état inactif, sauf si la plateforme est susceptible de rester dans cet état pendant au moins la durée spécifiée par BreakEvenDuration.

DependencyArrayUsed

Nombre d’éléments dans DependencyArray qui ont été remplis par le PEP.

DependencyArrayCount

Nombre d’éléments dans le tableau DependencyArray . Le tableau contient un élément pour chaque processeur de la plateforme matérielle.

DependencyArray[ANYSIZE_ARRAY]

Premier élément d’un tableau de structures PEP_PROCESSOR_IDLE_DEPENDENCY . Ce tableau spécifie l’ensemble des dépendances que l’état d’inactivité de la plateforme a sur chaque processeur. Si la plateforme contient N processeurs, le tableau contient N éléments, et les processeurs sont numérotés de 0 à N-1 dans l’ordre dans lequel ils sont représentés dans le tableau.

Remarques

Cette structure est utilisée conjointement avec la notification PEP_NOTIFY_PPM_QUERY_PLATFORM_STATE . Le membre d’État d’une structure PEP_PPM_QUERY_PLATFORM_STATE est une structure PEP_PLATFORM_IDLE_STATE .

Configuration requise

Condition requise Valeur
Client minimal pris en charge Pris en charge à partir de Windows 10.
En-tête pepfx.h (include Pep_x.h)

Voir aussi

PEP_NOTIFY_PPM_QUERY_PLATFORM_STATE

PEP_PPM_QUERY_IDLE_STATES_V2

PEP_PPM_QUERY_PLATFORM_STATE

PEP_PROCESSOR_IDLE_DEPENDENCY