Partager via

FormatFromRawValue, fonction

  • Article

Convertit une valeur de données de performances brute au format spécifié, ou deux valeurs de données de performances brutes si la conversion de format est basé sur l’heure.

Notes

Cette API est destinée à un usage interne uniquement. Elle n’est pas destinée à être utilisée dans le code du développeur.

Syntaxe

int FormatFromRawValue (
   [in] uint                    dwCounterType,
   [in] uint                    dwFormat,
   [in] long*                   pTimeBase,
   [in] PDH_RAW_COUNTER*        pRawValue1,
   [in] PDH_RAW_COUNTER*        pRawValue2,
   [out] PDH_FMT_COUNTERVALUE*  pFmtValue
);

Paramètres

dwCounterType
[in] Type de compteur. Pour obtenir la liste des types de compteurs, consultez Types de compteurs de performances WMI. dwCounterType peut être n’importe quel type de compteur, sauf pour PERF_LARGE_RAW_FRACTION et PERF_LARGE_RAW_BASE.

dwFormat
[in] Format dans lequel convertir les données de performance brute. Ce peut être l’une des valeurs suivantes :

Constant Valeur Description
PDH_FMT_DOUBLE 0x00000200 Retourne la valeur calculée sous la forme d’une valeur à virgule flottante double précision.
PDH_FMT_LARGE 0x00000400 Retourne la valeur calculée sous la forme d’un entier 64 bits.
PDH_FMT_LONG 0x00000100 Retourne la valeur calculée sous la forme d’un entier 32 bits.

L’une des valeurs précédentes peut être ORed avec l’un des indicateurs de mise à l’échelle suivants :

Constant Valeur Description
PDH_FMT_NOSCALE 0x00001000 N’appliquez pas les facteurs de mise à l’échelle du compteur.
PDH_FMT_1000 0x00002000 Multipliez la valeur finale par 1 000.

pTimeBase
[in] Pointeur vers la base de temps, si nécessaire pour la conversion de format. Si les informations de base de temps ne sont pas nécessaires pour la conversion de format, la valeur de ce paramètre est ignorée.

pRawValue1
[in] Pointeur vers une structure PDH_RAW_COUNTER représentant une valeur de performance brute.

pRawValue2
[in] Pointeur vers une structure PDH_RAW_COUNTER représentant une deuxième valeur de performance brute. Si une deuxième valeur de performance brute n’est pas nécessaire, ce paramètre doit être null.

pFmtValue
[out] Pointeur vers une structure PDH_FMT_COUNTERVALUE qui reçoit la valeur de performance mise en forme.

Valeur retournée

Cette fonction retourne les valeurs suivantes :

Constant Valeur Description
ERROR_SUCCESS 0 L’appel de fonction a réussi.
PDH_INVALID_ARGUMENT 0xC0000BBD Un argument requis est manquant ou non valide.
PDH_INVALID_HANDLE 0xC0000BBC Le handle n’est pas un objet PDH valide.

Notes

Cette fonction encapsule un appel à la fonction FormatFromRawValue.

Spécifications

Plateformes : Consultez Configuration requise.

Bibliothèque : PerfCounter.dll

Versions de .NET Framework : Disponibles à partir de la version 4.7.2

Voir aussi