structure PERF_COUNTERSET_REG_INFO (perflib.h)

Contient des informations sur le bloc PERF_COUNTERSET_REG_INFO qui contient la structure. Un bloc PERF_COUNTERSET_REG_INFO fournit des informations d’inscription pour un jeu de compteurs et les compteurs de performances qu’il contient, et se compose d’une structure de PERF_COUNTERSET_REG_INFO immédiatement suivie d’un ensemble PERF_COUNTER_REG_INFO structures qui correspondent aux compteurs de performances du jeu de compteurs.

Syntaxe

typedef struct _PERF_COUNTERSET_REG_INFO {
  GUID  CounterSetGuid;
  ULONG CounterSetType;
  ULONG DetailLevel;
  ULONG NumCounters;
  ULONG InstanceType;
} PERF_COUNTERSET_REG_INFO, *PPERF_COUNTERSET_REG_INFO;

Membres

CounterSetGuid

Identificateur unique du jeu de compteurs.

CounterSetType

Réservé.

DetailLevel

Audience cible pour les compteurs dans le jeu de compteurs.

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.

NumCounters

Nombre de structures PERF_COUNTER_REG_INFO dans ce bloc PERF_COUNTERSET_REG_INFO .

InstanceType

Spécifie si l'ensemble de compteurs autorise plusieurs instances telles que les processus et disques physiques, ou une instance unique telle que la mémoire.

Voici les types instance possibles.

Valeur	Signification
PERF_COUNTERSET_SINGLE_INSTANCE	L'ensemble de compteurs contient des compteurs d'instance unique, par exemple un compteur qui mesure la mémoire physique.
PERF_COUNTERSET_MULTI_INSTANCES	L'ensemble de compteurs contient des compteurs d'instances multiples, par exemple un compteur qui mesure les E/S de disque moyennes pour un processus.
PERF_COUNTERSET_SINGLE_AGGREGATE	L'ensemble de compteurs contient des compteurs d'instance unique dont la valeur d'agrégation est obtenue depuis une ou plusieurs sources. Par exemple, un compteur dans ce type d'ensemble de compteurs peut obtenir le nombre de lectures de chacun des trois disques durs sur l'ordinateur et additionner leurs valeurs.
PERF_COUNTERSET_MULTI_AGGREGATE	L'ensemble de compteurs contient des compteurs d'instances multiples dont la valeur d'agrégation est obtenue à partir de toutes les instances du compteur. Par exemple, un compteur de ce type de jeu de compteurs peut obtenir le temps d’exécution total des threads pour tous les threads d’une application multithread et additionner leurs valeurs.
PERF_COUNTERSET_SINGLE_AGGREGATE_HISTORY	La différence entre ce type et PERF_COUNTERSET_SINGLE_AGGREGATE est que ce type de jeu de compteurs stocke toutes les valeurs de compteur pendant la durée de vie de l’application consommateur (la valeur du compteur est mise en cache au-delà de la durée de vie du compteur). Par exemple, si l’un des disques durs de l’exemple d’agrégation unique ci-dessus devenait indisponible, le nombre total d’octets lus par ce disque serait toujours disponible et utilisé pour calculer la valeur d’agrégation.
PERF_COUNTERSET_INSTANCE_AGGREGATE	Non implémenté.

Remarques

La fonction PerfQueryCounterSetRegistrationInfo appelée avec le paramètre requestCode défini sur PERF_REG_COUNTERSET_STRUCT obtient un bloc PERF_COUNTERSET_REG_INFO .

Configuration requise

Condition requise	Valeur
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