Dela via

Funktionen FormatFromRawValue

Konverterar ett rådatavärde till det angivna formatet eller två rådatavärden om formatkonverteringen är tidsbaserad.

Anteckning

Det här API:et är endast för internt bruk. Det är inte avsett för användning från utvecklarkod.

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

Parametrar

dwCounterType
[i] Räknartypen. En lista över räknartyper finns i WMI-prestandaräknare. dwCounterType kan vara vilken räknare som helst förutom PERF_LARGE_RAW_FRACTION och PERF_LARGE_RAW_BASE.

dwFormat
[i] Formatet som rådata ska konverteras till. Det kan vara något av följande värden:

Konstant Värde Beskrivning
PDH_FMT_DOUBLE 0x00000200 Returnera det beräknade värdet som ett flyttal med dubbel precision.
PDH_FMT_LARGE 0x00000400 Returnera det beräknade värdet som ett 64-bitars heltal.
PDH_FMT_LONG 0x00000100 Returnera det beräknade värdet som ett 32-bitars heltal.

Ett av föregående värden kan vara ORed med någon av följande skalningsflaggor:

Konstant Värde Beskrivning
PDH_FMT_NOSCALE 0x00001000 Använd inte räknarens skalningsfaktorer.
PDH_FMT_1000 0x00002000 Multiplicera det slutliga värdet med 1 000.

pTimeBase
[i] En pekare till tidsbasen, om det behövs för formatkonverteringen. Om tidsbasinformation inte behövs för formatkonverteringen ignoreras värdet för den här parametern.

pRawValue1
[i] En pekare till en PDH_RAW_COUNTER struktur som representerar ett raw-prestandavärde.

pRawValue2
[i] En pekare till en PDH_RAW_COUNTER struktur som representerar ett andra råprestandavärde. Om ett andra raw-prestandavärde inte är nödvändigt bör den här parametern vara null.

pFmtValue
[ut] En pekare till en PDH_FMT_COUNTERVALUE struktur som tar emot det formaterade prestandavärdet.

Returvärde

Följande värden returneras av den här funktionen:

Konstant Värde Beskrivning
ERROR_SUCCESS 0 Funktionsanropet lyckas.
PDH_INVALID_ARGUMENT 0xC0000BBD Ett obligatoriskt argument saknas eller är felaktigt.
PDH_INVALID_HANDLE 0xC0000BBC Handtaget är inte ett giltigt PDH-objekt.

Kommentarer

Den här funktionen omsluter ett anrop till funktionen FormatFromRawValue .

Krav

Plattformar: Se Systemkrav.

Bibliotek: PerfCounter.dll

.NET Framework versioner: Tillgänglig sedan 4.7.2

Se även

  • Last updated on