structure PO_FX_COMPONENT_PERF_SET (wdm.h)

Article
08/08/2023

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)

Voir aussi

Gestion de l’état des performances des appareils

PO_FX_COMPONENT_PERF_INFO

PoFxRegisterComponentPerfStates

Partager via