structure PO_FX_COMPONENT_PERF_SET (wdm.h)
La structure PO_FX_COMPONENT_PERF_SET représente un ensemble d’états de performances pour un composant unique au sein d’un appareil.
Syntaxe
typedef struct _PO_FX_COMPONENT_PERF_SET {
UNICODE_STRING Name;
ULONGLONG Flags;
PO_FX_PERF_STATE_UNIT Unit;
PO_FX_PERF_STATE_TYPE Type;
union {
struct {
ULONG Count;
PPO_FX_PERF_STATE States;
} Discrete;
struct {
ULONGLONG Minimum;
ULONGLONG Maximum;
} Range;
};
} PO_FX_COMPONENT_PERF_SET, *PPO_FX_COMPONENT_PERF_SET;
Membres
Name
Chaîne de caractères facultative utilisée pour décrire la propriété du composant contrôlée par le jeu d’états de performances. Par exemple, « Fréquence d’horloge » ou « Bande passante mémoire ».
Flags
Défini sur 0. Actuellement, aucun indicateur n’est défini pour ce membre.
Unit
Valeur PO_FX_PERF_STATE_UNIT qui spécifie le type d’unité contrôlé par le jeu d’états de performances.
Type
Valeur PO_FX_PERF_STATE_TYPE qui spécifie le type d’états de performances dans l’ensemble (un nombre discret d’états ou une distribution continue d’états entre une valeur minimale et maximale).
Discrete
Pour les jeux qui représentent un nombre discret d’états de performances (autrement dit, où le membre type est PoFxPerfStateTypeDiscrete), cette structure imbriquée décrit les états.
Discrete.Count
Nombre d’états de performances dans l’ensemble.
Discrete.States
Pointeur vers un tableau PO_FX_PERF_STATE. La longueur de ce tableau est spécifiée par le membre count. Chaque élément de tableau décrit un état d’alimentation dans l’ensemble.
Range
Pour les jeux qui représentent une distribution continue des états de performances (autrement dit, où le membre type est PoFxPerfStateTypeRange), cette structure imbriquée décrit la valeur minimale et maximale de la plage d’états de performances.
Range.Minimum
Valeur d’état de performances minimale.
Range.Maximum
Valeur d’état de performances maximale.
Remarques
Lorsqu’un pilote de périphérique appelle la routine PoFxRegisterComponentPerfStates pour inscrire un composant pour la prise en charge de l’état des performances avec l’infrastructure de gestion de l’alimentation (PoFx), le pilote peut fournir une structure PO_FX_COMPONENT_PERF_INFO qui décrit les ensembles des états de performances pris en charge par le composant. Les PerfStateSets membre de la structure PO_FX_COMPONENT_PERF_INFO contiennent un tableau de structures PO_FX_COMPONENT_PERF_SET qui représentent les états de performances pris en charge.
La plupart des pilotes sont censés définir un ensemble unique d’états de performances par composant. Par exemple, un pilote peut définir un ensemble d’états de performances pour contrôler la fréquence d’horloge d’un composant. Toutefois, certains pilotes peuvent avoir besoin de définir plusieurs états de performances définis pour contrôler plusieurs dimensions d’états de performances pour un composant. Par exemple, un pilote peut définir deux ensembles d’états de performances pour contrôler la fréquence d’horloge et la bande passante de bus.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Prise en charge à partir de Windows 10. |
| d’en-tête | wdm.h (include Wudfwdm.h) |