structure PDH_COUNTER_INFO_A (pdh.h)

  • Article

La structure PDH_COUNTER_INFO contient des informations décrivant les propriétés d’un compteur. Ces informations incluent également le chemin du compteur.

Syntaxe

typedef struct _PDH_COUNTER_INFO_A {
  DWORD     dwLength;
  DWORD     dwType;
  DWORD     CVersion;
  DWORD     CStatus;
  LONG      lScale;
  LONG      lDefaultScale;
  DWORD_PTR dwUserData;
  DWORD_PTR dwQueryUserData;
  LPSTR     szFullPath;
  union {
    PDH_DATA_ITEM_PATH_ELEMENTS_A DataItemPath;
    PDH_COUNTER_PATH_ELEMENTS_A   CounterPath;
    struct {
      LPSTR szMachineName;
      LPSTR szObjectName;
      LPSTR szInstanceName;
      LPSTR szParentInstance;
      DWORD dwInstanceIndex;
      LPSTR szCounterName;
    };
  };
  LPSTR     szExplainText;
  DWORD     DataBuffer[1];
} PDH_COUNTER_INFO_A, *PPDH_COUNTER_INFO_A;

Membres

dwLength

Taille de la structure, y compris les chaînes ajoutées, en octets.

dwType

Type de compteur. Pour obtenir la liste des types de compteurs, consultez la section Types de compteurs du Kit de déploiement Windows Server 2003. Les constantes de type compteur sont définies dans Winperf.h.

CVersion

Informations sur la version du compteur. Non utilisé.

CStatus

Counter status qui indique si la valeur du compteur est valide. Pour obtenir la liste des valeurs possibles, consultez Vérification des valeurs de retour de l’interface PDH.

lScale

Facteur d’échelle à utiliser lors du calcul de la valeur d’affichage du compteur. Le facteur d’échelle est une puissance de dix. La plage valide de ce paramètre est PDH_MIN_SCALE (–7) (la valeur retournée est la valeur réelle fois 10–⁷) à PDH_MAX_SCALE (+7) (la valeur retournée est la valeur réelle fois 10⁺⁷). Une valeur de zéro définit l’échelle sur un, afin que la valeur réelle soit retournée

lDefaultScale

Facteur d’échelle par défaut suggéré par le fournisseur du compteur.

dwUserData

Valeur passée dans le paramètre dwUserData lors de l’appel de PdhAddCounter.

dwQueryUserData

Valeur passée dans le paramètre dwUserData lors de l’appel de PdhOpenQuery.

szFullPath

Chaîne terminée par null qui spécifie le chemin d’accès complet du compteur. La chaîne suit cette structure en mémoire.

DataItemPath

Structure PDH_DATA_ITEM_PATH_ELEMENTS . Non utilisé.

CounterPath

Structure PDH_COUNTER_PATH_ELEMENTS .

szMachineName

Chaîne terminée par null qui contient le nom de l’ordinateur spécifié dans le chemin du compteur. A la valeur NULL si le chemin d’accès ne spécifie pas d’ordinateur. La chaîne suit cette structure en mémoire.

szObjectName

Chaîne terminée par null qui contient le nom de l’objet de performance spécifié dans le chemin du compteur. La chaîne suit cette structure en mémoire.

szInstanceName

Chaîne terminée par null qui contient le nom de l’objet instance spécifié dans le chemin du compteur. A la valeur NULL si le chemin d’accès ne spécifie pas de instance. La chaîne suit cette structure en mémoire.

szParentInstance

Chaîne terminée par un caractère Null qui contient le nom du instance parent spécifié dans le chemin du compteur. A la valeur NULL si le chemin d’accès ne spécifie pas de instance parent. La chaîne suit cette structure en mémoire.

dwInstanceIndex

Index d’instance spécifié dans le chemin du compteur. A la valeur 0, si le chemin d’accès ne spécifie pas d’index instance.

szCounterName

Chaîne terminée par null qui contient le nom du compteur. La chaîne suit cette structure en mémoire.

szExplainText

Texte d’aide qui décrit le compteur. A la valeur NULL si la source est un fichier journal.

DataBuffer[1]

Début des données de chaîne qui sont ajoutées à la structure.

Remarques

Lorsque vous allouez de la mémoire pour cette structure, allouez suffisamment de mémoire pour les chaînes membres, telles que szCounterName, qui sont ajoutées à la fin de cette structure.

Configuration requise

Condition requise Valeur
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 pdh.h

Voir aussi

PDH_COUNTER_PATH_ELEMENTS

PDH_DATA_ITEM_PATH_ELEMENTS

PdhGetCounterInfo