Bagikan melalui


Menampilkan Data Performa

Sebagian besar penghitung memerlukan dua nilai sampel untuk menghitung nilai yang dapat ditampilkan. Rumus untuk setiap penghitung menentukan apakah penghitung memerlukan dua sampel. Untuk daftar penghitung dan rumusnya, lihat bagian Jenis Penghitung dari Kit Penyebaran Windows Server 2003.

Mengumpulkan Data Performa memperlihatkan cara mengambil data sampel. Setelah Anda memiliki sampel, Anda biasanya memanggil PdhGetFormattedCounterValue untuk menghitung nilai yang dapat ditampilkan.

Jika Anda perlu meningkatkan atau menurunkan skala nilai penghitung untuk menampilkan nilai, panggil fungsi PdhSetCounterScaleFactor sebelum memanggil PdhGetFormattedCounterValue. Nilai penghitung dapat diskalakan dengan kekuatan sepuluh dari faktor -7 hingga 7.

Jika jalur penghitung berisi karakter kartubebas untuk nama instans, panggil PdhGetFormattedCounterArray untuk mengambil array nilai penghitung yang diformat untuk setiap instans yang dikumpulkan.

Anda juga dapat menggunakan fungsi PdhCalculateCounterFromRawValue dan PdhFormatFromRawValue untuk menghitung nilai yang dapat ditampilkan. Untuk menggunakan fungsi-fungsi ini, Anda harus mengambil sampel yang dikumpulkan setelah setiap panggilan PdhCollectQueryData dan menyimpan sampel sendiri. Untuk mengambil sampel, panggil fungsi PdhGetRawCounterValue atau PdhGetRawCounterArray . Untuk nilai penghitung berbasis waktu, panggil PdhGetCounterTimeBase sebelum PdhFormatFromRawValue untuk mengambil basis waktu penghitung.

Jika Anda melakukan penghitungan menggunakan data mentah, selalu periksa anggota CStatus dari struktur PDH_RAW_COUNTER sebelum menggunakan sampel. Sampel tidak valid jika nilai CStatus tidak PDH_CSTATUS_NEW_DATA atau PDH_CSTATUS_VALID_DATA.

Menampilkan statistik untuk penghitung

Jika Anda ingin menghitung nilai minimum, maksimum, dan rata-rata penghitung, panggil fungsi PdhComputeCounterStatistics . Saat Anda mengumpulkan sampel, simpan struktur PDH_RAW_COUNTER dalam array yang Anda berikan ke PdhComputeCounterStatistics. Fungsi mengembalikan nilai statistik dalam struktur PDH_STATISTICS .

Anda juga dapat menggunakan fungsi ini untuk memadatkan file log. Misalnya, baca sepuluh rekaman dari file log, panggil PdhComputeCounterStatistics untuk menghitung nilai rata-rata lalu tulis nilai rata-rata ke file log output.