Fonction PdhFormatFromRawValue (pdh.h)

Article
08/25/2023

Calcule une valeur pouvant être affichée pour les valeurs de compteur brutes données.

Syntaxe

PDH_FUNCTION PdhFormatFromRawValue(
  [in]  DWORD                 dwCounterType,
  [in]  DWORD                 dwFormat,
  [in]  LONGLONG              *pTimeBase,
  [in]  PPDH_RAW_COUNTER      pRawValue1,
  [in]  PPDH_RAW_COUNTER      pRawValue2,
  [out] PPDH_FMT_COUNTERVALUE pFmtValue
);

Paramètres

[in] dwCounterType

Type de compteur. En règle générale, vous appelez PdhGetCounterInfo pour récupérer le type de compteur au moment où vous appelez PdhGetRawCounterValue pour récupérer la valeur brute du compteur.

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

Notez que vous ne pouvez pas spécifier de types de base, par exemple, PERF_LARGE_RAW_BASE.

[in] dwFormat

Détermine le type de données de la valeur calculée. Spécifiez l’une des valeurs suivantes.

Valeur	Signification
PDH_FMT_DOUBLE	Retourne la valeur calculée sous la forme d’un réel à virgule flottante double précision.
PDH_FMT_LARGE	Retourne la valeur calculée sous la forme d’un entier 64 bits.
PDH_FMT_LONG	Retourne la valeur calculée sous forme d’entier long.

Vous pouvez utiliser l’opérateur OR inclusif au niveau du bit (|) pour combiner le type de données avec l’un des facteurs de mise à l’échelle suivants.

Valeur	Signification
PDH_FMT_NOSCALE	N’appliquez pas le facteur de mise à l’échelle du compteur dans le calcul.
PDH_FMT_NOCAP100	Les valeurs de compteur supérieures à 100 (par exemple, les valeurs de compteur mesurant la charge du processeur sur les ordinateurs multiprocesseurs) ne sont pas réinitialisées à 100. Le comportement par défaut est que les valeurs de compteur sont limitées à une valeur de 100.
PDH_FMT_1000	Multipliez la valeur finale par 1 000.

[in] pTimeBase

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. Pour récupérer la base de temps du compteur, appelez PdhGetCounterTimeBase.

[in] pRawValue1

Valeur du compteur brut utilisée pour calculer la valeur du compteur affichable. Pour plus d’informations, consultez PDH_RAW_COUNTER.

[in] pRawValue2

Valeur du compteur brut utilisée pour calculer la valeur du compteur affichable. Pour plus d’informations, consultez PDH_RAW_COUNTER. Certains compteurs, par exemple les compteurs de débit, nécessitent deux valeurs brutes pour calculer une valeur pouvant être affichée. Si le type de compteur ne nécessite pas de deuxième valeur, définissez ce paramètre sur NULL. Cette valeur doit être la plus ancienne des deux valeurs brutes.

[out] pFmtValue

Une structure PDH_FMT_COUNTERVALUE qui reçoit la valeur de compteur calculée.

Valeur retournée

Si la fonction réussit, elle retourne ERROR_SUCCESS.

Si la fonction échoue, la valeur renvoyée est un code d’erreur système ou un code d’erreur PDH.

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]
Plateforme cible	Windows
En-tête	pdh.h
Bibliothèque	Pdh.lib
DLL	Pdh.dll

Voir aussi

PDH_FMT_COUNTERVALUE

PDH_RAW_COUNTER

PdhGetCounterInfo

PdhGetCounterTimeBase

PdhGetRawCounterValue

PdhReadRawLogRecord

Partager via