PdhCalculateCounterFromRawValue-Funktion (pdh.h)

Artikel
03/01/2024

Berechnet den angezeigten Wert von zwei unformatierten Zählerwerten.

Syntax

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
);

Parameter

[in] hCounter

Handle mit dem zu berechnenden Zähler. Die Funktion verwendet Informationen aus dem Zähler, um zu bestimmen, wie der Wert berechnet wird. Dieses Handle wird von der PdhAddCounter-Funktion zurückgegeben.

[in] dwFormat

Bestimmt den Datentyp des berechneten Werts. Geben Sie einen der folgenden Werte an.

Wert	Bedeutung
PDH_FMT_DOUBLE	Gibt den berechneten Wert als Gleitkommawert mit doppelter Genauigkeit zurück.
PDH_FMT_LARGE	Gibt den berechneten Wert als 64-Bit-Integer zurück.
PDH_FMT_LONG	Gibt den berechneten Wert als eine lange ganze Zahl zurück.

Sie können den bitweisen inklusiven OR-Operator (|) verwenden, um den Datentyp mit einem der folgenden Skalierungsfaktoren zu kombinieren.

Wert	Bedeutung
PDH_FMT_NOSCALE	Wenden Sie den Skalierungsfaktor des Zählers nicht in die Berechnung an.
PDH_FMT_NOCAP100	Zählerwerte größer als 100 (z. B. Zählerwerte, die die Prozessorlast auf Multiprozessorcomputern messen) werden nicht auf 100 zurückgesetzt. Das Standardverhalten besteht darin, dass Zählerwerte auf einen Wert von 100 begrenzt sind.
PDH_FMT_1000	Multiplizieren Sie den endgültigen Wert mit 1.000.

[in] rawValue1

Unformatierter Zählerwert, der zum Berechnen des anzeigebaren Zählerwerts verwendet wird. Ausführliche Informationen finden Sie in der PDH_RAW_COUNTER-Struktur .

[in] rawValue2

Unformatierter Zählerwert, der zum Berechnen des anzeigebaren Zählerwerts verwendet wird. Weitere Informationen finden Sie unter PDH_RAW_COUNTER. Einige Leistungsindikatoren (z. B. Ratenzähler) erfordern zwei Rohwerte, um einen anzeigebaren Wert zu berechnen. Wenn für den Zählertyp kein zweiter Wert erforderlich ist, legen Sie diesen Parameter auf NULL fest. Dieser Wert muss der ältere der beiden Rohwerte sein.

[out] fmtValue

Eine PDH_FMT_COUNTERVALUE-Struktur , die den berechneten Zählerwert empfängt.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird ERROR_SUCCESS zurückgegeben.

Wenn die Funktion fehlschlägt, ist der Rückgabewert ein Systemfehlercode oder ein PDH-Fehlercode. Die folgenden Werte sind möglich.

Rückgabecode	Beschreibung
PDH_INVALID_ARGUMENT	Ein Argument ist nicht korrekt oder falsch formatiert.
PDH_INVALID_HANDLE	Das Zählerhandle ist ungültig.

Hinweise

Um den aktuellen Unformatierten Zählerwert aus der Abfrage abzurufen, rufen Sie die PdhGetRawCounterValue-Funktion auf.

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

PDH_FMT_COUNTERVALUE

PDH_RAW_COUNTER

PdhGetFormattedCounterValue

PdhGetRawCounterValue

PdhSetCounterScaleFactor

Freigeben über