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é de composant contrôlée par le jeu d’état de performances. Par exemple, « Fréquence d’horloge » ou « Bande passante mémoire ».
Flags
Définit la valeur 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’état 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 une valeur maximale).
Discrete
Pour les jeux qui représentent un nombre discret d’états de performances (c’est-à-dire, 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 (c’est-à-dire, 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 minimale de l’état des performances.
Range.Maximum
Valeur d’état des performances maximales.
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 d’états de performances pris en charge par le composant. Le membre PerfStateSets de la structure PO_FX_COMPONENT_PERF_INFO contient 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 ensembles d’états de performances pour contrôler plusieurs dimensions des états de performances d’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 du bus.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Pris en charge à partir de Windows 10. |
| En-tête | wdm.h (inclure Wudfwdm.h) |