PERF_COUNTER_IDENTIFIER structure (perflib.h)

Article
08/25/2023

Contient des informations sur le bloc PERF_COUNTER_IDENTIFIER qui contient la structure. Un bloc PERF_COUNTER_IDENTIFIER fournit des informations sur une spécification de compteur de performances et se compose des éléments suivants dans l’ordre :

Structure PERF_COUNTER_IDENTIFIER
Chaîne UTF-16LE terminée par une valeur Null facultative qui spécifie le nom du instance
Remplissage si nécessaire pour faire de la taille du bloc un multiple de 8 octets.

Syntaxe

typedef struct _PERF_COUNTER_IDENTIFIER {
  GUID  CounterSetGuid;
  ULONG Status;
  ULONG Size;
  ULONG CounterId;
  ULONG InstanceId;
  ULONG Index;
  ULONG Reserved;
} PERF_COUNTER_IDENTIFIER, *PPERF_COUNTER_IDENTIFIER;

Membres

CounterSetGuid

GUID du jeu de compteurs de performances.

Status

Code d’erreur qui indique si l’opération d’ajout ou de suppression d’un compteur de performances a réussi ou échoué.

Size

Taille totale du bloc PERF_COUNTER_IDENTIFIER , en octets. La taille totale du bloc correspond à la somme des tailles de la structure PERF_COUNTER_IDENTIFIER, de la chaîne qui spécifie le nom du instance et du remplissage.

CounterId

Identificateur du compteur de performances. PERF_WILDCARD_COUNTER spécifie tous les compteurs.

InstanceId

Identificateur de l'instance. Spécifiez 0xFFFFFFFF si vous ne souhaitez pas filtrer les résultats en fonction de l’identificateur instance.

Index

Position dans la séquence de blocs PERF_COUNTER_IDENTIFIER à laquelle les données de compteur qui correspondent à ce bloc PERF_COUNTER_IDENTIFIER sont retournées. Défini par PerfQueryCounterInfo.

Reserved

Réservé.

Remarques

Lorsque vous spécifiez un identificateur de jeu de compteurs pour un jeu de compteurs à instance unique, vous ne devez pas spécifier le nom instance dans les données supplémentaires du bloc PERF_COUNTER_IDENTIFIER. La taille du bloc PERF_COUNTER_IDENTIFIER doit être la taille de la structure PERF_COUNTER_IDENTIFIER .

En revanche, lorsque vous spécifiez un identificateur de jeu de compteurs pour un jeu de compteurs à plusieurs instance, vous devez spécifier le nom instance dans les données supplémentaires du bloc PERF_COUNTER_IDENTIFIER. L’identificateur n’est pas valide, sauf si la taille du bloc PERF_COUNTER_IDENTIFIER est supérieure à la taille de la structure PERF_COUNTER_IDENTIFIER . Si vous ne souhaitez pas filtrer les jeux de compteurs en fonction du nom instance, utilisez PERF_WILDCARD_INSTANCE comme nom de instance.

Les fonctions PerfAddCounters et PerfDeleteCounters acceptent une séquence de blocs PERF_COUNTER_IDENTIFIER pour définir les spécifications de compteur que vous souhaitez ajouter ou supprimer d’une requête.

La fonction PerfQueryCounterInfo obtient une séquence de blocs PERF_COUNTER_IDENTIFIER pour indiquer les spécifications de compteur dans une requête et pour indiquer dans le membre Index l’ordre dans lequel la requête obtient les résultats.

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

Voir aussi

PerfAddCounters

PerfDeleteCounters

PerfQueryCounterInfo

Partager via