PERF_COUNTER_DEFINITION structure (winperf.h)

Article
08/27/2023

Décrit un compteur de performances.

Syntaxe

typedef struct _PERF_COUNTER_DEFINITION {
  DWORD  ByteLength;
  DWORD  CounterNameTitleIndex;
#if ...
  DWORD  CounterNameTitle;
#else
  LPWSTR CounterNameTitle;
#endif
  DWORD  CounterHelpTitleIndex;
#if ...
  DWORD  CounterHelpTitle;
#else
  LPWSTR CounterHelpTitle;
#endif
  LONG   DefaultScale;
  DWORD  DetailLevel;
  DWORD  CounterType;
  DWORD  CounterSize;
  DWORD  CounterOffset;
} PERF_COUNTER_DEFINITION, *PPERF_COUNTER_DEFINITION;

Membres

ByteLength

Taille de cette structure, en octets.

CounterNameTitleIndex

Index du nom du compteur dans la base de données title. Pour plus d’informations sur l’utilisation de l’index pour récupérer le nom du compteur, consultez Récupération des noms de compteurs et du texte d’aide.

Pour définir cette valeur, les fournisseurs ajoutent la valeur de décalage du compteur définie dans leur fichier de symboles à la valeur de Registre First Counter . Pour plus d’informations, consultez Ajout de noms et de descriptions de compteurs au Registre et Implémentation de la fonction OpenPerformanceData.

Cette valeur doit être égale à zéro si le compteur est un compteur de base (CounterType inclut l’indicateur PERF_COUNTER_BASE).

CounterNameTitle

Réservé.

CounterHelpTitleIndex

Indexer le texte d’aide du compteur dans la base de données de titre. Pour plus d’informations sur l’utilisation de l’index pour récupérer le texte d’aide du compteur, consultez Récupération des noms de compteurs et du texte d’aide.

Pour définir cette valeur, les fournisseurs ajoutent la valeur de décalage du compteur définie dans leur fichier de symboles à la valeur de Registre First Help . Pour plus d’informations, consultez Ajout de noms et de descriptions de compteurs au Registre et Implémentation de la fonction OpenPerformanceData.

Cette valeur doit être égale à zéro si le compteur est un compteur de base (CounterType inclut l’indicateur PERF_COUNTER_BASE).

CounterHelpTitle

Réservé.

DefaultScale

Facteur d’échelle à utiliser lors du graphique de la valeur du compteur. Les valeurs valides vont de -7 à 7 (les valeurs correspondent à 0,00000001 - 10000000). 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.

DetailLevel

Niveau de détail du compteur. Les consommateurs utilisent cette valeur pour contrôler la complexité de l’affichage. Ce membre peut être l’une des valeurs suivantes.

Niveau de détail	Signification
PERF_DETAIL_NOVICE	Les données du compteur sont fournies pour tous les utilisateurs.
PERF_DETAIL_ADVANCED	Les données du compteur sont fournies pour les utilisateurs avancés.
PERF_DETAIL_EXPERT	Les données du compteur sont fournies aux utilisateurs experts.
PERF_DETAIL_WIZARD	Les données de compteur sont fournies pour les concepteurs système.

CounterType

Type de compteur. Pour obtenir la liste des 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.

CounterSize

Taille du compteur, en octets.

Actuellement, seuls les DWORD (4 octets) et les ULONGLONG (8 octets) sont utilisés pour fournir des valeurs de compteur.

CounterOffset

Décalage du début de la structure PERF_COUNTER_BLOCK au premier octet de ce compteur. L’emplacement de la structure PERF_COUNTER_BLOCK dans le bloc PERF_OBJECT_TYPE varie selon que l’objet contient des instances. Pour plus d’informations, consultez Format des données de performances.

Notez que plusieurs compteurs peuvent utiliser les mêmes données brutes et pointer vers le même décalage dans le bloc PERF_COUNTER_BLOCK .

Remarques

Une structure PERF_OBJECT_TYPE contient un ou plusieurs compteurs. Cette structure définit chaque compteur et donne le décalage à sa valeur. Ces structures suivent la structure PERF_OBJECT_TYPE en mémoire. Pour plus d’informations, consultez Format des données de performances.

Les fournisseurs doivent fournir leurs compteurs dans le même ordre chaque fois que leurs compteurs sont interrogés. Si le compteur utilise un compteur de base dans son calcul (le type de compteur inclut l’indicateur PERF_COUNTER_FRACTION ), le compteur de base doit suivre ce compteur dans la liste des compteurs. Si le type de compteur inclut l’indicateur PERF_MULTI_COUNTER , la deuxième valeur de compteur doit suivre la valeur de ce compteur dans le bloc PERF_COUNTER_BLOCK .

Configuration requise


Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
En-tête	winperf.h (inclure Windows.h)

Voir aussi

PERF_COUNTER_BLOCK

PERF_OBJECT_TYPE

Partager via