Fungsi FormatFromRawValue

Mengonversi satu nilai data performa mentah ke format yang ditentukan, atau dua nilai data performa mentah jika konversi format berbasis waktu.

Catatan

API ini hanya untuk penggunaan internal. API ini tidak dimaksudkan untuk digunakan dari kode pengembang.

Sintaks

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] Jenis penghitung. Untuk daftar jenis penghitung, lihat Jenis Penghitung Kinerja WMI. dwCounterType dapat berupa jenis penghitung apa pun kecuali untuk PERF_LARGE_RAW_FRACTION dan PERF_LARGE_RAW_BASE.

dwFormat
[in] Format untuk mengonversi data performa mentah. Jenis dapat berupa salah satu dari nilai berikut:

Terus-menerus	Nilai	Deskripsi
PDH_FMT_DOUBLE	0x00000200	Kembalikan nilai yang dihitung sebagai nilai penunjuk floating presisi ganda.
PDH_FMT_LARGE	0x00000400	Kembalikan nilai yang dihitung sebagai bilangan bulat 64-bit.
PDH_FMT_LONG	0x00000100	Kembalikan nilai yang dihitung sebagai bilangan bulat 32-bit.

Salah satu nilai sebelumnya dapat di-OR dengan salah satu bendera penskalaan berikut:

Terus-menerus	Nilai	Deskripsi
PDH_FMT_NOSCALE	0x00001000	Jangan menerapkan faktor penskalaan penghitung.
PDH_FMT_1000	0x00002000	Kalikan nilai akhir dengan 1.000.

pTimeBase
[in] Penunjuk ke basis waktu, jika perlu untuk konversi format. Jika informasi basis waktu tidak diperlukan untuk konversi format, nilai parameter ini diabaikan.

pRawValue1
[in] Penunjuk ke struktur PDH_RAW_COUNTER yang mewakili nilai performa mentah.

pRawValue2
[in] Penunjuk ke struktur PDH_RAW_COUNTER yang mewakili nilai performa mentah. Jika nilai performa mentah kedua tidak diperlukan, parameter ini harus null.

pFmtValue
[out] Penunjuk ke struktur PDH_FMT_COUNTERVALUE yang menerima nilai performa yang diformat.

Mengembalikan nilai

Nilai-nilai berikut dikembalikan oleh fungsi ini:

Terus-menerus	Nilai	Deskripsi
ERROR_SUCCESS	0	Panggilan fungsi berhasil.
PDH_INVALID_ARGUMENT	0xC0000BBD	Argumen yang diperlukan hilang atau salah.
PDH_INVALID_HANDLE	0xC0000BBC	Handel bukanlah objek PDH yang valid.

Keterangan

Fungsi ini membungkus panggilan ke fungsi FormatFromRawValue.

Persyaratan

Platform: Lihat Persyaratan Sistem.

Pustaka: PerfCounter.dll

Versi .NET Framework: Tersedia mulai dari 4.7.2

Lihat juga

• WMI dan Penghitung Kinerja (Referensi API Tidak Terkelola)