Fungsi PdhGetFormattedCounterValue (pdh.h)

  • Artikel

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