Delen via

FormatFromRawValue, functie

Converteert één waarde voor onbewerkte prestatiegegevens naar de opgegeven indeling of twee onbewerkte prestatiegegevenswaarden als de indelingsconversie op tijd is gebaseerd.

Notitie

Deze API is alleen voor intern gebruik. Het is niet bedoeld voor gebruik vanuit ontwikkelaarscode.

Syntaxis

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

Parameters

dwCounterType
[in] Het tellertype. Zie WMI-prestatiemeteritemtypen voor een lijst met typen tellers. dwCounterType kan elk type teller zijn, met uitzondering van PERF_LARGE_RAW_FRACTION en PERF_LARGE_RAW_BASE.

dwFormat
[in] De indeling waarnaar de onbewerkte prestatiegegevens moeten worden geconverteerd. Dit kan een van de volgende waarden zijn:

Constant Waarde Beschrijving
PDH_FMT_DOUBLE 0x00000200 Retourneert de berekende waarde als een zwevende kommawaarde met dubbele precisie.
PDH_FMT_LARGE 0x00000400 Retourneert de berekende waarde als een 64-bits geheel getal.
PDH_FMT_LONG 0x00000100 Retourneert de berekende waarde als een 32-bits geheel getal.

Een van de vorige waarden kan ORed zijn met een van de volgende schaalmarkeringen:

Constant Waarde Beschrijving
PDH_FMT_NOSCALE 0x00001000 Pas de schaalfactoren van het tellerbestand niet toe.
PDH_FMT_1000 0x00002000 Vermenigvuldig de uiteindelijke waarde met 1000.

pTimeBase
[in] Een verwijzing naar de tijdbasis, indien nodig voor de indelingsconversie. Als tijdbasisgegevens niet nodig zijn voor de indelingsconversie, wordt de waarde van deze parameter genegeerd.

pRawValue1
[in] Een aanwijzer naar een PDH_RAW_COUNTER structuur die een onbewerkte prestatiewaarde vertegenwoordigt.

pRawValue2
[in] Een aanwijzer naar een PDH_RAW_COUNTER structuur die een tweede onbewerkte prestatiewaarde vertegenwoordigt. Als een tweede onbewerkte prestatiewaarde niet nodig is, moet deze parameter zijn null.

pFmtValue
[uit] Een aanwijzer naar een PDH_FMT_COUNTERVALUE structuur die de opgemaakte prestatiewaarde ontvangt.

Retourwaarde

De volgende waarden worden geretourneerd door deze functie:

Constant Waarde Beschrijving
ERROR_SUCCESS 0 De functie-aanroep is geslaagd.
PDH_INVALID_ARGUMENT 0xC0000BBD Een vereist argument ontbreekt of is onjuist.
PDH_INVALID_HANDLE 0xC0000BBC De ingang is geen geldig PDH-object.

Opmerkingen

Deze functie verpakt een aanroep naar de functie FormatFromRawValue .

Vereisten

Platforms: Zie Systeemvereisten.

Bibliotheek: PerfCounter.dll

.NET Framework versies: beschikbaar sinds 4.7.2

Zie ook

  • Last updated on