PERF_COUNTER_HEADER structure (perflib.h)

Article
08/25/2023

Contient des informations sur le bloc PERF_COUNTER_HEADER qui contient la structure. Un bloc PERF_COUNTER_HEADER fournit des informations et des données d’erreur pour les requêtes de compteur de performances, et se compose d’une structure de PERF_COUNTER_HEADER suivie de données de compteur de performances supplémentaires.

Syntaxe

typedef struct _PERF_COUNTER_HEADER {
  ULONG               dwStatus;
  PerfCounterDataType dwType;
  ULONG               dwSize;
  ULONG               Reserved;
} PERF_COUNTER_HEADER, *PPERF_COUNTER_HEADER;

Membres

dwStatus

Code d’erreur qui indique si l’opération d’interrogation des performances a réussi ou échoué.

dwType

Type d’informations de compteur de performances fournies par le bloc PERF_COUNTER_HEADER .

Valeur	Signification
PERF_ERROR_RETURN	Erreur résultant d’une requête de compteur de performances. La bibliothèque de performances ne peut pas récupérer les données de compteur valides du fournisseur. Aucune donnée supplémentaire ne suit la structure PERF_COUNTER_HEADER . Le membre dwStatus de la structure contient le code d’erreur.
PERF_SINGLE_COUNTER	Résultat d’une requête mono-compteur instance, par exemple, « \Processor(_Total)\% Processor Time ». Les données supplémentaires se composent d’un bloc PERF_COUNTER_DATA .
PERF_MULTIPLE_COUNTERS	Résultat d’une requête à instance à plusieurs compteurs, par exemple , « \Processor(_Total)\* ». Les données supplémentaires se composent d’un bloc PERF_MULTI_COUNTERS suivi de blocs PERF_COUNTER_DATA .
PERF_MULTIPLE_INSTANCES	Résultat d’une requête multi-instance à compteur unique, par exemple , « \Processor(*)\% Processor Time ». Les données supplémentaires se composent d’un bloc PERF_MULTI_INSTANCES.
PERF_COUNTERSET	Résultat d’une requête multi-compteurs instance, par exemple , « \Processor()\ ». Les données supplémentaires se composent d’un bloc PERF_MULTI_COUNTERS suivi d’un bloc PERF_MULTI_INSTANCES .

dwSize

Taille totale du bloc PERF_COUNTER_HEADER , qui est égale à la somme de la taille de la structure PERF_COUNTER_HEADER et de la taille des données supplémentaires.

Reserved

Réservé.

Notes

La fonction PerfQueryCounterData retourne un bloc PERF_DATA_HEADER qui contient une séquence de blocs PERF_COUNTER_HEADER .

Spécifications


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

Partager via