PdhFormatFromRawValue-Funktion (pdh.h)

Artikel
03/01/2024

Berechnet einen anzeigebaren Wert für die angegebenen Unformatierten Zählerwerte.

Syntax

PDH_FUNCTION PdhFormatFromRawValue(
  [in]  DWORD                 dwCounterType,
  [in]  DWORD                 dwFormat,
  [in]  LONGLONG              *pTimeBase,
  [in]  PPDH_RAW_COUNTER      pRawValue1,
  [in]  PPDH_RAW_COUNTER      pRawValue2,
  [out] PPDH_FMT_COUNTERVALUE pFmtValue
);

Parameter

[in] dwCounterType

Typ des Zählers. In der Regel rufen Sie PdhGetCounterInfo auf, um den Zählertyp zu dem Zeitpunkt abzurufen, zu dem Sie PdhGetRawCounterValue aufrufen, um den unformatierten Zählerwert abzurufen.

Eine Liste der Leistungsindikatorentypen finden Sie im Abschnitt Leistungsindikatorentypen des Windows Server 2003 Deployment Kit. (Die Konstantenwerte werden in Winperf.h definiert.)

Beachten Sie, dass Sie keine Basistypen angeben können, z. B. PERF_LARGE_RAW_BASE.

[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 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 nicht den Skalierungsfaktor des Zählers in der 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] pTimeBase

Zeiger auf die Zeitbasis, falls erforderlich für die Formatkonvertierung. Wenn Zeitbasisinformationen für die Formatkonvertierung nicht erforderlich sind, wird der Wert dieses Parameters ignoriert. Um die Zeitbasis des Indikators abzurufen, rufen Sie PdhGetCounterTimeBase auf.

[in] pRawValue1

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

[in] pRawValue2

Unformatierter Zählerwert, der zum Berechnen des anzeigebaren Zählerwerts verwendet wird. Ausführliche Informationen finden Sie unter PDH_RAW_COUNTER. Einige Leistungsindikatoren, z. B. Ratenindikatoren, erfordern zwei Rohwerte, um einen anzeigebaren Wert zu berechnen. Wenn der Zählertyp keinen zweiten Wert erfordert, legen Sie diesen Parameter auf NULL fest. Dieser Wert muss der ältere der beiden Rohwerte sein.

[out] pFmtValue

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

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.

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

PdhGetCounterInfo

PdhGetCounterTimeBase

PdhGetRawCounterValue

PdhReadRawLogRecord

Freigeben über