Fonction PdhSetCounterScaleFactor (pdh.h)

Article
03/01/2024

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

Partager via