Affichage des données de performances
La plupart des compteurs nécessitent deux exemples de valeurs pour calculer une valeur affichable. La formule de chaque compteur détermine si le compteur nécessite deux exemples. Pour obtenir la liste des compteurs et leurs formules, consultez la section Types de compteurs du Kit de déploiement Windows Server 2003.
La collecte des données de performances montre comment récupérer des exemples de données. Une fois que vous avez les exemples, vous appelez généralement PdhGetFormattedCounterValue pour calculer une valeur d’affichage.
Si vous devez mettre à l’échelle la valeur du compteur vers le haut ou vers le bas pour afficher la valeur, appelez la fonction PdhSetCounterScaleFactor avant d’appeler PdhGetFormattedCounterValue. Les valeurs de compteur peuvent être mises à l’échelle d’une puissance de dix d’un facteur de -7 à 7.
Si le chemin du compteur contient un caractère générique pour le nom instance, appelez PdhGetFormattedCounterArray pour récupérer un tableau de valeurs de compteur mises en forme pour chaque instance collecté.
Vous pouvez également utiliser les fonctions PdhCalculateCounterFromRawValue et PdhFormatFromRawValue pour calculer une valeur d’affichage. Pour utiliser ces fonctions, vous devez récupérer l’exemple collecté après chaque appel PdhCollectQueryData et stocker l’exemple vous-même. Pour récupérer l’exemple, appelez la fonction PdhGetRawCounterValue ou PdhGetRawCounterArray . Pour les valeurs de compteur basées sur le temps, appelez PdhGetCounterTimeBase avant PdhFormatFromRawValue pour récupérer la base de temps du compteur.
Si vous effectuez des calculs à l’aide des données brutes, case activée toujours le membre CStatus de la structure PDH_RAW_COUNTER avant d’utiliser l’exemple. L’exemple n’est pas valide si la valeur de CStatus n’est pas PDH_CSTATUS_NEW_DATA ou PDH_CSTATUS_VALID_DATA.
Affichage des statistiques pour un compteur
Si vous souhaitez calculer les valeurs minimales, maximales et moyennes d’un compteur, appelez la fonction PdhComputeCounterStatistics . Lorsque vous collectez des exemples, stockez les structures PDH_RAW_COUNTER dans un tableau que vous passez à PdhComputeCounterStatistics. La fonction retourne les valeurs statistiques dans une structure PDH_STATISTICS .
Vous pouvez également utiliser cette fonction pour compresser un fichier journal. Par exemple, lisez dix enregistrements à partir d’un fichier journal, appelez PdhComputeCounterStatistics pour calculer la valeur moyenne, puis écrivez la valeur moyenne dans un fichier journal de sortie.