Fonction PdhSetCounterScaleFactor (pdh.h)

  • Article

Définit le facteur d’échelle appliqué à la valeur calculée du compteur spécifié lorsque vous demandez la valeur du compteur mis en forme. Si l’indicateur PDH_FMT_NOSCALE est défini, ce facteur d’échelle est ignoré.

Syntaxe

PDH_FUNCTION PdhSetCounterScaleFactor(
  [in] PDH_HCOUNTER hCounter,
  [in] LONG         lFactor
);

Paramètres

[in] hCounter

Handle du compteur à appliquer le facteur d’échelle. La fonction PdhAddCounter retourne ce handle.

[in] lFactor

Puissance de dix par laquelle multiplier la valeur calculée avant de la renvoyer. La valeur minimale de ce paramètre est PDH_MIN_SCALE (–7), où la valeur retournée est la valeur réelle multipliée par 10 à ⁷. La valeur maximale de ce paramètre est PDH_MAX_SCALE (+7), où la valeur retournée est la valeur réelle multipliée par 10⁺⁷. Une valeur de zéro définit l’échelle sur un, de sorte que la valeur réelle soit retourné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
 La valeur de mise à l’échelle est hors de la plage.
PDH_INVALID_HANDLE
 Le handle de compteur n’est pas valide.

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

PdhCalculateCounterFromRawValue

PdhComputeCounterStatistics

PdhGetFormattedCounterValue