Fungsi PdhFormatFromRawValue (pdh.h)

Artikel
03/08/2023

Menghitung nilai yang dapat ditampilkan untuk nilai penghitung mentah yang diberikan.

Sintaks

PDH_FUNCTION PdhFormatFromRawValue(
  [in]  DWORD                 dwCounterType,
  [in]  DWORD                 dwFormat,
  [in]  LONGLONG              *pTimeBase,
  [in]  PPDH_RAW_COUNTER      pRawValue1,
  [in]  PPDH_RAW_COUNTER      pRawValue2,
  [out] PPDH_FMT_COUNTERVALUE pFmtValue
);

Parameter

[in] dwCounterType

Jenis penghitung. Biasanya, Anda memanggil PdhGetCounterInfo untuk mengambil jenis penghitung pada saat Anda memanggil PdhGetRawCounterValue untuk mengambil nilai penghitung mentah.

Untuk daftar jenis penghitung, lihat bagian Jenis Penghitung dari Kit Penyebaran Windows Server 2003. (Nilai konstanta ditentukan dalam Winperf.h.)

Perhatikan bahwa Anda tidak dapat menentukan jenis dasar, misalnya, PERF_LARGE_RAW_BASE.

[in] dwFormat

Menentukan jenis data dari nilai yang dihitung. Tentukan salah satu nilai berikut.

Nilai	Makna
PDH_FMT_DOUBLE	Mengembalikan nilai terhitung sebagai titik floating presisi ganda nyata.
PDH_FMT_LARGE	Kembalikan nilai yang dihitung sebagai bilangan bulat 64-bit.
PDH_FMT_LONG	Mengembalikan nilai terhitung sebagai bilangan bulat panjang.

Anda bisa menggunakan operator OR inklusif bitwise (|) untuk menggabungkan tipe data dengan salah satu faktor penskalaan berikut.

Nilai	Makna
PDH_FMT_NOSCALE	Jangan menerapkan faktor penskalakan penghitung dalam perhitungan.
PDH_FMT_NOCAP100	Nilai penghitung yang lebih besar dari 100 (misalnya, nilai penghitung yang mengukur beban prosesor pada komputer multiprosesor) tidak akan diatur ulang ke 100. Perilaku default adalah bahwa nilai penghitung dibatasi pada nilai 100.
PDH_FMT_1000	Kalikan nilai akhir dengan 1.000.

[in] pTimeBase

Arahkan ke basis waktu, jika perlu untuk konversi format. Jika informasi basis waktu tidak diperlukan untuk konversi format, nilai parameter ini diabaikan. Untuk mengambil basis waktu penghitung, panggil PdhGetCounterTimeBase.

[in] pRawValue1

Nilai penghitung mentah yang digunakan untuk menghitung nilai penghitung yang dapat ditampilkan. Untuk detailnya, lihat PDH_RAW_COUNTER.

[in] pRawValue2

Nilai penghitung mentah yang digunakan untuk menghitung nilai penghitung yang dapat ditampilkan. Untuk detailnya, lihat PDH_RAW_COUNTER. Beberapa penghitung, misalnya, penghitung tarif, memerlukan dua nilai mentah untuk menghitung nilai yang dapat ditampilkan. Jika jenis penghitung tidak memerlukan nilai kedua, atur parameter ini ke NULL. Nilai ini harus lebih lama dari dua nilai mentah.

[out] pFmtValue

Struktur PDH_FMT_COUNTERVALUE yang menerima nilai penghitung yang dihitung.

Nilai kembali

Jika fungsi berhasil, fungsi akan mengembalikan ERROR_SUCCESS.

Jika fungsi gagal, nilai yang dikembalikan adalah kode kesalahan sistem atau kode kesalahan PDH.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	pdh.h
Pustaka	Pdh.lib
DLL	Pdh.dll

Lihat juga

PDH_FMT_COUNTERVALUE

PDH_RAW_COUNTER

PdhGetCounterInfo

PdhGetCounterTimeBase

PdhGetRawCounterValue

PdhReadRawLogRecord

Bagikan melalui