Freigeben über


PdhCalculateCounterFromRawValue-Funktion (pdh.h)

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