Fungsi PdhGetFormattedCounterValue (pdh.h)

Artikel
25/08/2023

Menghitung nilai yang dapat ditampilkan untuk penghitung yang ditentukan.

Sintaks

PDH_FUNCTION PdhGetFormattedCounterValue(
  [in]  PDH_HCOUNTER          hCounter,
  [in]  DWORD                 dwFormat,
  [out] LPDWORD               lpdwType,
  [out] PPDH_FMT_COUNTERVALUE pValue
);

Parameter

[in] hCounter

Tangani penghitung yang ingin Anda komputasi nilai yang dapat ditampilkan. Fungsi PdhAddCounter mengembalikan handel ini.

[in] dwFormat

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

Nilai	Makna
PDH_FMT_DOUBLE	Mengembalikan data sebagai titik floating presisi ganda nyata.
PDH_FMT_LARGE	Mengembalikan data sebagai bilangan bulat 64-bit.
PDH_FMT_LONG	Mengembalikan data 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 terapkan faktor penskalakan default penghitung.
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 aktual dengan 1.000.

[out] lpdwType

Menerima jenis penghitung. Untuk daftar jenis penghitung, lihat bagian Jenis Penghitung dari Kit Penyebaran Windows Server 2003. Parameter ini bersifat opsional.

[out] pValue

Struktur PDH_FMT_COUNTERVALUE yang menerima nilai penghitung.

Mengembalikan nilai

Jika fungsi berhasil, fungsi akan mengembalikan ERROR_SUCCESS.

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

Menampilkan kode	Deskripsi
PDH_INVALID_ARGUMENT	Parameter tidak valid atau salah diformat.
PDH_INVALID_DATA	Penghitung yang ditentukan tidak berisi data yang valid atau kode status yang berhasil.
PDH_INVALID_HANDLE	Handel penghitung tidak valid.

Keterangan

Data untuk penghitung dikunci (dilindungi) selama panggilan ke PdhGetFormattedCounterValue untuk mencegah perubahan apa pun selama pemrosesan panggilan. Membaca data (memanggil fungsi ini dengan sukses) menghapus bendera yang diubah data untuk penghitung.

Beberapa penghitung, seperti penghitung tarif, memerlukan dua nilai penghitung untuk menghitung nilai yang dapat ditampilkan. Dalam hal ini Anda harus memanggil PdhCollectQueryData dua kali sebelum memanggil PdhGetFormattedCounterValue. Untuk informasi selengkapnya, lihat Mengumpulkan Data Performa.

Jika instans penghitung yang ditentukan tidak ada, metode akan mengembalikan PDH_INVALID_DATA dan mengatur anggota CStatus dari struktur PDH_FMT_COUNTERVALUE ke PDH_CSTATUS_NO_INSTANCE.

Sebelum Windows Server 2003: Panggilan format mungkin gagal untuk penghitung yang hanya memerlukan satu nilai ketika instans tidak ditemukan. Coba panggil kueri dan format panggilan lagi. Jika panggilan format gagal untuk kedua kalinya, instans tidak ditemukan. Sebagai alternatif, Anda dapat memanggil fungsi PdhEnumObjects dengan opsi refresh diatur ke TRUE untuk menyegarkan instans penghitung sebelum mengkueri dan memformat data penghitung.

Contoh

Misalnya, lihat Menelusuri Penghitung Kinerja atau Membaca Data Performa dari File Log.

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

PdhCollectQueryData

PdhGetRawCounterValue

PdhSetCounterScaleFactor

Bagikan melalui