structure PDH_COUNTER_INFO_W (pdh.h)
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_W {
DWORD dwLength;
DWORD dwType;
DWORD CVersion;
DWORD CStatus;
LONG lScale;
LONG lDefaultScale;
DWORD_PTR dwUserData;
DWORD_PTR dwQueryUserData;
LPWSTR szFullPath;
union {
PDH_DATA_ITEM_PATH_ELEMENTS_W DataItemPath;
PDH_COUNTER_PATH_ELEMENTS_W CounterPath;
struct {
LPWSTR szMachineName;
LPWSTR szObjectName;
LPWSTR szInstanceName;
LPWSTR szParentInstance;
DWORD dwInstanceIndex;
LPWSTR szCounterName;
};
};
LPWSTR szExplainText;
DWORD DataBuffer[1];
} PDH_COUNTER_INFO_W, *PPDH_COUNTER_INFO_W;
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 de compteur sont définies dans Winperf.h.
CVersion
Informations sur la version du compteur. Non utilisé.
CStatus
Compteur 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 de mise à l’é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, de sorte que la valeur réelle soit retournée
lDefaultScale
Facteur de mise à l’échelle par défaut suggéré par le fournisseur du compteur.
dwUserData
Valeur transmise dans le paramètre dwUserData lors de l’appel de PdhAddCounter.
dwQueryUserData
Valeur transmise 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 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 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 |