PdhCalculateCounterFromRawValue, fonction (pdh.h)

  • Article

Calcule la valeur d’affichage de deux valeurs de compteur brutes.

Syntaxe

PDH_FUNCTION PdhCalculateCounterFromRawValue(
  [in]  PDH_HCOUNTER          hCounter,
  [in]  DWORD                 dwFormat,
  [in]  PPDH_RAW_COUNTER      rawValue1,
  [in]  PPDH_RAW_COUNTER      rawValue2,
  [out] PPDH_FMT_COUNTERVALUE fmtValue
);

Paramètres

[in] hCounter

Gérez le compteur à calculer. La fonction utilise les informations du compteur pour déterminer comment calculer la valeur. Ce handle est retourné par la fonction PdhAddCounter .

[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] rawValue1

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

[in] rawValue2

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] fmtValue

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. Voici les valeurs possibles.

Code de retour Description
PDH_INVALID_ARGUMENT
 Un argument n’est pas correct ou n’est pas correctement mis en forme.
PDH_INVALID_HANDLE
 Le handle de compteur n’est pas valide.

Remarques

Pour récupérer la valeur du compteur brut actuelle à partir de la requête, appelez la fonction PdhGetRawCounterValue .

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

PdhGetFormattedCounterValue

PdhGetRawCounterValue

PdhSetCounterScaleFactor