Sdílet prostřednictvím

Funkce FormatFromRawValue

Převede jednu nezpracovanou hodnotu dat o výkonu do zadaného formátu nebo dvě nezpracované hodnoty dat o výkonu, pokud je převod formátu časově založený.

Poznámka

Toto rozhraní API je určené pouze pro interní použití. Není určen pro použití z kódu vývojáře.

Syntaxe

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

Parametry

dwCounterType
[v] Typ čítače. Seznam typů čítačů najdete v tématu Typy čítačů výkonu rozhraní WMI. dwCounterType může být libovolný typ čítače PERF_LARGE_RAW_FRACTION s výjimkou a PERF_LARGE_RAW_BASE.

dwFormat
[v] Formát, do kterého chcete převést nezpracovaná data o výkonu. Může to být jedna z následujících hodnot:

Konstanta Hodnota Popis
PDH_FMT_DOUBLE 0x00000200 Vrátí počítanou hodnotu jako hodnotu s plovoucí desetinnou čárkou s dvojitou přesností.
PDH_FMT_LARGE 0x00000400 Vrátí počítanou hodnotu jako 64bitové celé číslo.
PDH_FMT_LONG 0x00000100 Vrátí počítanou hodnotu jako 32bitové celé číslo.

Jedna z předchozích hodnot může být ORed s jedním z následujících příznaků škálování:

Konstanta Hodnota Popis
PDH_FMT_NOSCALE 0x00001000 Neaplikujte faktory škálování čítače.
PDH_FMT_1000 0x00002000 Vynásobte konečnou hodnotu číslem 1 000.

pTimeBase
[v] Ukazatel na časovou základnu, pokud je to nutné pro převod formátu. Pokud informace o časovém základu nejsou nezbytné pro převod formátu, hodnota tohoto parametru je ignorována.

pRawValue1
[v] Ukazatel na PDH_RAW_COUNTER strukturu, která představuje nezpracovanou hodnotu výkonu.

pRawValue2
[v] Ukazatel na PDH_RAW_COUNTER strukturu, která představuje druhou nezpracovanou hodnotu výkonu. Pokud není potřeba použít druhou nezpracovanou hodnotu výkonu, měl by tento parametr být null.

pFmtValue
[out] Ukazatel na PDH_FMT_COUNTERVALUE strukturu, která přijímá formátovanou hodnotu výkonu.

Vrácená hodnota

Tato funkce vrátí následující hodnoty:

Konstanta Hodnota Popis
ERROR_SUCCESS 0 Volání funkce bylo úspěšné.
PDH_INVALID_ARGUMENT 0xC0000BBD Požadovaný argument chybí nebo je nesprávný.
PDH_INVALID_HANDLE 0xC0000BBC Popisovač není platným objektem PDH.

Poznámky

Tato funkce zabalí volání funkce FormatFromRawValue .

Požadavky

Platformy: Viz Požadavky na systém.

Knihovna: PerfCounter.dll

Verze rozhraní .NET Framework: K dispozici od verze 4.7.2

Viz také

  • Last updated on