FormatFromRawValue függvény

Egy nyers teljesítményadat-értéket konvertál a megadott formátumra, vagy két nyers teljesítményadat-értéket, ha a formátumkonverzió időalapú.

Megjegyzés

Ez az API csak belső használatra készült. Nem fejlesztői kódból való használatra készült.

Szintaxis

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

Paraméterek

dwCounterType
[in] A számláló típusa. A számlálótípusok listáját lásd: WMI teljesítményszámláló-típusok. dwCounterTypeA és PERF_LARGE_RAW_BASEa kivételével PERF_LARGE_RAW_FRACTION bármilyen számlálótípus lehet.

dwFormat
[in] A nyers teljesítményadatok konvertálásának formátuma. A következő értékek egyike lehet:

Állandó	Érték	Leírás
PDH_FMT_DOUBLE	0x00000200	A számított értéket dupla pontosságú lebegőpontos értékként adja vissza.
PDH_FMT_LARGE	0x00000400	A számított értéket 64 bites egész számként adja vissza.
PDH_FMT_LONG	0x00000100	A számított értéket 32 bites egész számként adja vissza.

Az egyik korábbi érték lehet az ORed az alábbi skálázási jelzők egyikével:

Állandó	Érték	Leírás
PDH_FMT_NOSCALE	0x00001000	Ne alkalmazza a számláló skálázási tényezőit.
PDH_FMT_1000	0x00002000	Szorozza meg a végső értéket 1000-gyel.

pTimeBase
[in] Az időbázisra mutató mutató, ha a formátumkonvertáláshoz szükséges. Ha a formátumkonvertáláshoz nincs szükség időbázis-információra, a paraméter értékét a rendszer figyelmen kívül hagyja.

pRawValue1
[in] Egy nyers teljesítményértéket PDH_RAW_COUNTER képviselő struktúra mutatója.

pRawValue2
[in] Egy második nyers teljesítményértéket PDH_RAW_COUNTER jelölő struktúra mutatója. Ha nincs szükség második nyers teljesítményértékre, ennek a paraméternek a következőnek kell lennie null: .

pFmtValue
[kifelé] A formázott teljesítményértéket fogadó struktúra mutatója PDH_FMT_COUNTERVALUE .

Visszatérési érték

A függvény a következő értékeket adja vissza:

Állandó	Érték	Leírás
ERROR_SUCCESS	0	A függvényhívás sikeres.
PDH_INVALID_ARGUMENT	0xC0000BBD	Hiányzik vagy helytelen egy kötelező argumentum.
PDH_INVALID_HANDLE	0xC0000BBC	A leíró nem érvényes PDH-objektum.

Megjegyzések

Ez a függvény a FormatFromRawValue függvény hívását burkolja.

Követelmények

Platformok: Lásd: Rendszerkövetelmények.

Kódtár: PerfCounter.dll

.NET-keretrendszer verziók: 4.7.2 óta érhető el

Lásd még

• WMI- és teljesítményszámlálók (nem felügyelt API-referencia)