PdhSetCounterScaleFactor-Funktion (pdh.h)
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 |
|---|---|
|
Der Skalierungswert liegt außerhalb des Bereichs. |
|
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 |