structure PEP_COMPONENT_PERF_SET (pepfx.h)

  • Article

La structure PEP_COMPONENT_PERF_SET décrit les états de performances (P-states) dans un ensemble d’états P.

Syntaxe

typedef struct _PEP_COMPONENT_PERF_SET {
  UNICODE_STRING      Name;
  ULONGLONG           Flags;
  PEP_PERF_STATE_UNIT Unit;
  PEP_PERF_STATE_TYPE Type;
  union {
    struct {
      ULONG           Count;
      PPEP_PERF_STATE States;
    } Discrete;
    struct {
      ULONGLONG Minimum;
      ULONGLONG Maximum;
    } Range;
  };
} PEP_COMPONENT_PERF_SET, *PPEP_COMPONENT_PERF_SET;

Membres

Name

Chaîne facultative qui décrit la propriété d’appareil contrôlée par ce jeu d’état P. Par exemple, cette chaîne peut être « Fréquence d’horloge » ou « Bande passante mémoire ». Si aucune chaîne de ce type n’est disponible pour cet état P, le membre Name a la valeur NULL. Sinon, ce membre contient un pointeur vers une structure UNICODE_STRING qui contient la chaîne.

Flags

Définit la valeur zéro. Aucun bits d’indicateur n’est actuellement défini pour ce membre.

Unit

Structure PEP_PERF_STATE_UNIT qui spécifie les unités dans lesquelles les valeurs de performances de ce jeu d’état P sont exprimées. Les performances des composants peuvent être exprimées en hertz (fréquence) ou en bits par seconde (bande passante).

Type

Valeur d’énumération PEP_PERF_STATE_TYPE qui indique le type d’informations de performances spécifié pour ce composant. Ce membre indique si les valeurs de performances de ce jeu d’états P sont spécifiées sous la forme d’une liste de valeurs discrètes ou d’une plage continue de valeurs.

Discrete

Liste des valeurs de performances discrètes pour ce jeu d’état P.

Discrete.Count

Nombre d’états P dans cet ensemble d’états P.

Discrete.States

Pointeur vers un tableau de structures PEP_PERF_STATE , chacune d’elles décrivant une valeur de performances discrète dans ce jeu d’état P. Le membre Count spécifie le nombre d’éléments dans ce tableau. Un état P est identifié par son index de tableau. Si le tableau contient N éléments, les index d’état P vont de 0 à N-1.

Range

Plage de valeurs de mesure des performances discrètes pour ce jeu d’état P.

Range.Minimum

Valeur minimale dans la plage. Cette valeur est exprimée dans les unités indiquées par le membre d’unité .

Range.Maximum

Valeur maximale dans la plage. Cette valeur est exprimée dans les unités indiquées par le membre d’unité .

Remarques

L’union sans nom contient les valeurs de mesure des performances pour cet état P. Cette union contient une liste de valeurs discrètes (si Type == PepPerfStateTypeDiscrete) ou une plage continue de valeurs (si Type == PepPerfStateTypeRange).

Le membre PerfStateSets du PEP_COMPONENT_PERF_INFO est le premier élément d’un tableau de structures PEP_COMPONENT_PERF_SET . Tous les membres de la structure PEP_COMPONENT_PERF_SET contiennent des valeurs d’entrée fournies par l’infrastructure de gestion de l’alimentation Windows (PoFx). Le plug-in d’extension de plateforme (PEP) ne doit pas écrire dans cette structure.

Les pilotes de périphérique utilisent la structure PO_FX_COMPONENT_PERF_SET , qui est similaire à la structure PEP_COMPONENT_PERF_SET .

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