FormatFromRawValue-Funktion

Artikel
06/05/2023

Konvertiert einen Rohdatenleistungswert in das angegebene Format oder zwei Rohdatenleistungswerte, wenn die Formatkonvertierung zeitabhängig ist.

Hinweis

Diese API ist ausschließlich für die interne Verwendung vorgesehen. Sie ist nicht für die Verwendung im Entwicklercode vorgesehen.

Syntax

int FormatFromRawValue (
   [in] uint                    dwCounterType,
   [in] uint                    dwFormat,
   [in] long*                   pTimeBase,
   [in] PDH_RAW_COUNTER*        pRawValue1,
   [in] PDH_RAW_COUNTER*        pRawValue2,
   [out] PDH_FMT_COUNTERVALUE*  pFmtValue
);

Parameter

dwCounterType
[in] Der Zählertyp. Eine Liste der Zählertypen finden Sie unter WMI-Leistungsindikatortypen. dwCounterType kann ein beliebiger Zählertyp mit Ausnahme von PERF_LARGE_RAW_FRACTION und PERF_LARGE_RAW_BASE sein.

dwFormat
[in] Das Format, in das die rohen Leistungsdaten konvertiert werden sollen. Es kann sich um einen der folgenden Werte handeln:

Konstante	Wert	BESCHREIBUNG
`PDH_FMT_DOUBLE`	0x00000200	Gibt den berechneten Wert als Gleitkommawert mit doppelter Genauigkeit zurück.
`PDH_FMT_LARGE`	0x00000400	Gibt den berechneten Wert als 64-Bit-Integer zurück.
`PDH_FMT_LONG`	0x00000100	Gibt den berechneten Wert als 32-Bit-Integer zurück.

Einer der vorherigen Werte kann ORed mit einem der folgenden Skalierungsflags sein:

Konstante	Wert	Beschreibung
`PDH_FMT_NOSCALE`	0x00001000	Wenden Sie nicht die Skalierungsfaktoren des Zählers an.
`PDH_FMT_1000`	0x00002000	Multiplizieren Sie den endgültigen Wert mit 1.000.

pTimeBase
[in] Ein 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.

pRawValue1
[in] Ein Zeiger auf eine PDH_RAW_COUNTER-Struktur, die einen Rohleistungswert darstellt.

pRawValue2
[in] Ein Zeiger auf eine PDH_RAW_COUNTER-Struktur, die einen zweiten Rohleistungswert darstellt. Wenn ein zweiter Rohleistungswert nicht erforderlich ist, sollte dieser Parameter null sein.

pFmtValue
[out] Ein Zeiger auf eine PDH_FMT_COUNTERVALUE-Struktur, die den formatierten Leistungswert empfängt.

Rückgabewert

Die folgenden Werte werden von dieser Funktion zurückgegeben:

Konstante	Wert	BESCHREIBUNG
`ERROR_SUCCESS`	0	Der Funktionsaufruf war erfolgreich.
`PDH_INVALID_ARGUMENT`	0xC0000BBD	Ein erforderliches Argument fehlt oder ist falsch.
`PDH_INVALID_HANDLE`	0xC0000BBC	Das Handle ist kein gültiges PDH-Objekt.

Bemerkungen

Diese Funktion umschließt einen Aufruf der FormatFromRawValue-Funktion.

Anforderungen

Plattformen: Informationen finden Sie unter Systemanforderungen.

Bibliothek: PerfCounter.dll

.NET Framework-Versionen: seit Version 4.7.2 verfügbar

Siehe auch

WMI und Leistungsindikatoren (Referenz zur nicht verwalteten API)

Freigeben über