PERF_COUNTER_REG_INFO structure (perflib.h)

  • Article

Fournit des informations d’inscription sur un compteur de performances.

Syntaxe

typedef struct _PERF_COUNTER_REG_INFO {
  ULONG     CounterId;
  ULONG     Type;
  ULONGLONG Attrib;
  ULONG     DetailLevel;
  LONG      DefaultScale;
  ULONG     BaseCounterId;
  ULONG     PerfTimeId;
  ULONG     PerfFreqId;
  ULONG     MultiId;
  ULONG     AggregateFunc;
  ULONG     Reserved;
} PERF_COUNTER_REG_INFO, *PPERF_COUNTER_REG_INFO;

Membres

CounterId

Identificateur unique du compteur de performances dans le jeu de compteurs. Un jeu de compteurs peut contenir un maximum de 64 000 compteurs de performances.

Type

Type du compteur de performances. Pour plus d’informations sur les types de compteurs prédéfinis, consultez la section Types de compteurs du Kit de déploiement Windows Server 2003. Les consommateurs utilisent le type de compteur pour déterminer comment calculer et afficher la valeur du compteur. Les fournisseurs doivent limiter leur choix de types de compteurs à la liste prédéfinie.

Les valeurs possibles sont les suivantes :

PERF_100NSEC_MULTI_TIMER

PERF_100NSEC_MULTI_TIMER_II

PERF_100NSEC_TIMER

PERF_100NSEC_TIMER_INV

PERF_AVERAGE_BASE

PERF_AVERAGE_BULK

PERF_AVERAGE_TIMER

PERF_COUNTER_100NS_QUEUELEN_TYPE

PERF_COUNTER_BULK_COUNT

PERF_COUNTER_COUNTER

PERF_COUNTER_DELTA

PERF_COUNTER_LARGE_DELTA

PERF_COUNTER_LARGE_QUEUELEN_TYPE

PERF_COUNTER_LARGE_RAWCOUNT

PERF_COUNTER_LARGE_RAWCOUNT_HEX

PERF_COUNTER_MULTI_TIMER

PERF_COUNTER_MULTI_TIMER_INV

PERF_COUNTER_OBJ_QUEUELEN_TYPE

PERF_COUNTER_RAWCOUNT

PERF_COUNTER_RAWCOUNT_HEX

PERF_COUNTER_TEXT

PERF_COUNTER_TIMER

PERF_COUNTER_TIMER_INV

PERF_ELAPSED_TIME

PERF_LARGE_RAW_BASE

PERF_OBJ_TIME_TIMER

PERF_PRECISION_100NS_TIMER

PERF_PRECISION_TIMER

PERF_PRECISION_OBJECT_TIMER

PERF_RAW_BASE

PERF_RAW_FRACTION

PERF_SAMPLE_COUNTER

PERF_SAMPLE_FRACTION

Attrib

Un ou plusieurs attributs qui indiquent comment afficher ce compteur.

Les valeurs possibles sont les suivantes :

Valeur Signification
PERF_ATTRIB_BY_REFERENCE
 Récupérez la valeur du compteur par référence plutôt que par valeur.
PERF_ATTRIB_NO_DISPLAYABLE
 N’affichez pas la valeur du compteur.
PERF_ATTRIB_NO_GROUP_SEPARATOR
 N’utilisez pas de séparateurs de chiffres lors de l’affichage de la valeur du compteur.
PERF_ATTRIB_DISPLAY_AS_REAL
 Afficher la valeur du compteur sous la forme d’une valeur réelle.
PERF_ATTRIB_DISPLAY_AS_HEX
 Afficher la valeur du compteur sous la forme d’un nombre hexadécimal.
 

Les attributs PERF_ATTRIB_NO_GROUP_SEPARATOR, PERF_ATTRIB_DISPLAY_AS_REAL et PERF_ATTRIB_DISPLAY_AS_HEX ne s’excluent pas mutuellement. Si vous spécifiez les trois attributs, la priorité est donnée aux attributs dans l’ordre donné.

DetailLevel

Public cible du compteur.

Les valeurs possibles sont les suivantes :

Valeur Signification
PERF_DETAIL_NOVICE
 Vous pouvez afficher le compteur à n’importe quel niveau d’utilisateur.
PERF_DETAIL_ADVANCED
 Le compteur est compliqué et ne doit être affiché que pour les utilisateurs avancés.

DefaultScale

Facteur de mise à l’échelle à appliquer à la valeur du compteur de performances brute. Les valeurs valides vont de –10 à 10. Zéro si aucune échelle n’est appliquée. Si cette valeur est égale à zéro, la valeur d’échelle est 1 ; si cette valeur est 1, la valeur d’échelle est 10 ; si cette valeur est –1, la valeur d’échelle est .10 ; et ainsi de suite. La valeur mise à l’échelle du compteur de performances est égale à la valeur brute du compteur de performances multipliée par 10 pour atteindre la puissance spécifiée par le membre DefaultScale .

BaseCounterId

Identificateur du compteur de base. 0xFFFFFFFF indique qu’il n’existe aucun compteur de base.

PerfTimeId

Identificateur du compteur de performances. 0xFFFFFFFF indique qu’il n’existe aucun compteur de performances.

PerfFreqId

Identificateur du compteur de fréquence. 0xFFFFFFFF indique qu’il n’existe aucun compteur de fréquence.

MultiId

Identificateur de compteur du compteur multiple. 0xFFFFFFFF indique qu’il n’existe pas de compteur multiple.

AggregateFunc

Fonction d’agrégation que le client doit appliquer au compteur si

l’ensemble de compteurs auquel appartient le compteur est de type Global Aggregate, Multiple

Agrégat d’instances ou Historique d’agrégation global. Le client spécifie les instances de compteur sur lesquelles l’agrégation est effectuée si le type de jeu de compteurs

est un agrégat d’instances multiples ; sinon, le client doit agréger des valeurs

sur toutes les instances du jeu de compteurs. L’une des valeurs suivantes doit être

Spécifié.

Valeur Signification
PERF_AGGREGATE_UNDEFINED
 Non défini.
PERF_AGGREGATE_TOTAL
 Somme des valeurs des instances de compteur retournées.
PERF_AGGREGATE_AVG
 Moyenne des valeurs des instances de compteur retournées.
PERF_AGGREGATE_MIN
 Valeur minimale du compteur retourné instance valeurs.
PERF_AGGREGATE_MAX
Valeur maximale du compteur retourné instance valeurs.

Reserved

Réservé.

Notes

La fonction PerfQueryCounterSetRegistrationInfo appelée avec le paramètre requestCode défini sur PERF_REG_COUNTERSET_STRUCT obtient un bloc PERF_COUNTERSET_REG_INFO qui contient une ou plusieurs structures PERF_COUNTER_REG_INFO .

La fonction PerfQueryCounterSetRegistrationInfo appelée avec le paramètre requestCode défini sur PERF_REG_COUNTER_STRUCT obtient une structure PERF_COUNTER_REG_INFO .

Spécifications

   
Client minimal pris en charge Windows 10, version 1607 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2016 (applications de bureau uniquement)
En-tête perflib.h

Voir aussi

PERF_COUNTERSET_REG_INFO

PerfQueryCounterSetRegistrationInfo