PdhSetCounterScaleFactor-Funktion (pdh.h)

  • Artikel

Legt den Skalierungsfaktor fest, der auf den berechneten Wert des angegebenen Indikators angewendet wird, wenn Sie den formatierten Zählerwert anfordern. Wenn das flag PDH_FMT_NOSCALE festgelegt ist, wird dieser Skalierungsfaktor ignoriert.

Syntax

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

Parameter

[in] hCounter

Handle des Zählers, auf den der Skalierungsfaktor angewendet werden soll. Die PdhAddCounter-Funktion gibt dieses Handle zurück.

[in] lFactor

Leistung von zehn, mit der der berechnete Wert vor der Rückgabe multipliziert werden soll. Der Mindestwert dieses Parameters ist PDH_MIN_SCALE (–7), wobei der zurückgegebene Wert der tatsächliche Wert ist, der mit 10–⁷ multipliziert wird. Der Höchstwert dieses Parameters ist PDH_MAX_SCALE (+7), wobei der zurückgegebene Wert der tatsächliche Wert ist, multipliziert mit 10⁺⁷. Ein Wert von 0 legt die Skalierung auf 1 fest, sodass der tatsächliche Wert zurückgegeben wird.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt sie ERROR_SUCCESS zurück.

Wenn die Funktion fehlschlägt, ist der Rückgabewert ein Systemfehlercode oder ein PDH-Fehlercode. Im Folgenden sind mögliche Werte aufgeführt.

Rückgabecode Beschreibung
PDH_INVALID_ARGUMENT
 Der Skalierungswert liegt außerhalb des Bereichs.
PDH_INVALID_HANDLE
 Das Zählerhandle ist ungültig.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile pdh.h
Bibliothek Pdh.lib
DLL Pdh.dll

Weitere Informationen

PdhCalculateCounterFromRawValue

PdhComputeCounterStatistics

PdhGetFormattedCounterValue