FormatFromRawValue-Funktion

  • Artikel

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