Partager via

structure PEP_COMPONENT_PERF_SET (pep_x.h)

  • Article

La structure PEP_COMPONENT_PERF_SET décrit les états de performances (états P) dans un jeu 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é de l’appareil contrôlée par ce jeu d’états 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éfini sur 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’états 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ées 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 en tant que plage continue de valeurs.

Discrete

Liste des valeurs de performances discrètes pour cet ensemble d’états P.

Discrete.Count

Nombre d’états P dans ce jeu d’états P.

Discrete.States

Pointeur vers un tableau de structures PEP_PERF_STATE, chacun décrivant une valeur de performances discrète dans ce jeu d’états P. Le membre Count spécifie le nombre d’éléments de ce tableau. Un état P est identifié par son index de tableau. Si le tableau contient des éléments N, les index d’état P sont comprises entre 0 et N–1.

Range

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

Range.Minimum

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

Range.Maximum

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

Remarques

L’union non nommée 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 PerfStateSets membre 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.

Exigences

Exigence Valeur
client minimum pris en charge Prise en charge à partir de Windows 10.
d’en-tête pep_x.h (inclure Pep_x.h)

Voir aussi