PERF_COUNTER_IDENTIFIER structure (perflib.h)
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 |