structure PERF_COUNTER_INFO (perflib.h)

Article
08/25/2023

Définit des informations sur un compteur utilisé par un fournisseur. L’outil CTRPP génère automatiquement cette structure en fonction du schéma que vous spécifiez.

Syntaxe

typedef struct _PERF_COUNTER_INFO {
  ULONG     CounterId;
  ULONG     Type;
  ULONGLONG Attrib;
  ULONG     Size;
  ULONG     DetailLevel;
  LONG      Scale;
  ULONG     Offset;
} PERF_COUNTER_INFO, *PPERF_COUNTER_INFO;

Membres

CounterId

Identificateur qui identifie de manière unique le compteur dans le jeu de compteurs.

Type

Spécifie le type de compteur. Pour connaître les types de compteurs possibles, consultez Types de compteurs dans le Guide de déploiement de Windows 2003.

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 numériques lors de l’affichage de la valeur du compteur.
PERF_ATTRIB_DISPLAY_AS_REAL	Affichez la valeur du compteur sous forme de valeur réelle.
PERF_ATTRIB_DISPLAY_AS_HEX	Affichez 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é.

Size

Taille, en octets, de cette structure.

DetailLevel

Spécifiez le 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 doit être affiché uniquement pour les utilisateurs avancés.

Scale

Facteur de mise à l’échelle à appliquer à la valeur du compteur. Les valeurs valides sont comprises entre –10 et 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.

Offset

Décalage d’octet entre le début du bloc PERF_COUNTERSET_INSTANCE et la valeur du compteur.

Remarques

Cette structure est contenue dans un bloc PERF_COUNTERSET_INFO ou PERF_COUNTERSET_INSTANCE .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
En-tête	perflib.h

Voir aussi

PERF_COUNTERSET_INFO

PERF_COUNTERSET_INSTANCE

Partager via