structure PEP_COMPONENT_PERF_SET (pepfx.h)
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 | pepfx.h (include Pep_x.h) |