struktur PERF_OBJECT_TYPE (winperf.h)

Artikel
03/08/2023

Menjelaskan informasi performa khusus objek, misalnya, jumlah instans objek dan jumlah penghitung yang ditentukan objek.

Sintaks

typedef struct _PERF_OBJECT_TYPE {
  DWORD         TotalByteLength;
  DWORD         DefinitionLength;
  DWORD         HeaderLength;
  DWORD         ObjectNameTitleIndex;
#if ...
  DWORD         ObjectNameTitle;
#else
  LPWSTR        ObjectNameTitle;
#endif
  DWORD         ObjectHelpTitleIndex;
#if ...
  DWORD         ObjectHelpTitle;
#else
  LPWSTR        ObjectHelpTitle;
#endif
  DWORD         DetailLevel;
  DWORD         NumCounters;
  LONG          DefaultCounter;
  LONG          NumInstances;
  DWORD         CodePage;
  LARGE_INTEGER PerfTime;
  LARGE_INTEGER PerfFreq;
} PERF_OBJECT_TYPE, *PPERF_OBJECT_TYPE;

Anggota

TotalByteLength

Ukuran data khusus objek, dalam byte. Anggota ini adalah offset dari awal struktur ini ke struktur PERF_OBJECT_TYPE berikutnya, jika ada.

DefinitionLength

Ukuran struktur ini ditambah ukuran semua
PERF_COUNTER_DEFINITION struktur.

Jika objek adalah beberapa objek instans (anggota NumInstances bukan nol), anggota ini adalah offset dari awal struktur ini hingga struktur PERF_INSTANCE_DEFINITION pertama. Jika tidak, nilai ini adalah offset ke PERF_COUNTER_BLOCK.

HeaderLength

Ukuran struktur ini, dalam byte. Anggota ini adalah offset dari awal struktur ini hingga struktur PERF_COUNTER_DEFINITION pertama.

ObjectNameTitleIndex

Indeks ke nama objek dalam database judul. Untuk detail tentang menggunakan indeks untuk mengambil nama objek, lihat Mengambil Nama Penghitung dan Teks Bantuan.

Penyedia menentukan nilai indeks dalam file inisialisasi mereka. Untuk detailnya, lihat Menambahkan Nama dan Deskripsi Penghitung ke Registri.

ObjectNameTitle

Dicadangkan.

ObjectHelpTitleIndex

Indeks ke teks bantuan objek dalam database judul. Untuk detail tentang menggunakan indeks untuk mengambil teks bantuan objek, lihat Mengambil Nama Penghitung dan Teks Bantuan.

Penyedia menentukan nilai indeks dalam file inisialisasi mereka. Untuk detailnya, lihat Menambahkan Nama dan Deskripsi Penghitung ke Registri.

ObjectHelpTitle

Dicadangkan.

DetailLevel

Tingkat detail. Konsumen menggunakan nilai ini untuk mengontrol kompleksitas tampilan. Nilai ini adalah tingkat detail minimum dari semua penghitung untuk objek tertentu. Anggota ini bisa menjadi salah satu nilai berikut.

Tingkat detail	Makna
PERF_DETAIL_NOVICE	Data penghitung disediakan untuk semua pengguna.
PERF_DETAIL_ADVANCED	Data penghitung disediakan untuk pengguna tingkat lanjut.
PERF_DETAIL_EXPERT	Data penghitung disediakan untuk pengguna ahli.
PERF_DETAIL_WIZARD	Data penghitung disediakan untuk perancang sistem.

NumCounters

Jumlah blok PERF_COUNTER_DEFINITION yang dikembalikan oleh objek .

DefaultCounter

Indeks ke nama penghitung dalam database judul penghitung default yang informasinya akan ditampilkan ketika objek ini dipilih di alat Performa. Anggota ini mungkin –1 untuk menunjukkan bahwa tidak ada default.

NumInstances

Jumlah instans objek yang penghitungnya disediakan. Jika objek dapat memiliki nol atau lebih instans, tetapi tidak memiliki saat ini, nilai ini harus nol. Jika objek tidak dapat memiliki beberapa instans, nilai ini harus PERF_NO_INSTANCES.

CodePage

Anggota ini nol jika string instans adalah string Unicode. Jika tidak, anggota ini adalah pengidentifikasi halaman kode dari nama instans. Anda dapat menggunakan nilai halaman kode saat memanggil MultiByteToWideChar untuk mengonversi string ke Unicode.

PerfTime

Penyedia menghasilkan tanda waktu yang digunakan konsumen saat menghitung nilai penghitung. Misalnya, ini bisa menjadi nilai saat ini, dalam hitungan, dari penghitung kinerja resolusi tinggi.

Penyedia perlu memberikan nilai ini jika jenis penghitung penghitung mereka menyertakan bendera PERF_OBJECT_TIMER . Jika tidak, konsumen menggunakan nilai PerfTime dari PERF_DATA_BLOCK.

PerfFreq

Penyedia menghasilkan nilai frekuensi yang digunakan konsumen saat menghitung nilai penghitung. Misalnya, ini bisa menjadi frekuensi saat ini, dalam hitungan per detik, dari penghitung kinerja resolusi tinggi.

Penyedia perlu memberikan nilai ini jika jenis penghitung penghitung mereka menyertakan bendera PERF_OBJECT_TIMER . Jika tidak, konsumen menggunakan nilai PerfFreq dari PERF_DATA_BLOCK.

Keterangan

Penyedia menggunakan struktur ini untuk menyediakan data performa untuk objek yang mereka dukung. Konsumen menggunakan struktur ini untuk menggunakan data performa untuk objek yang mereka kueri.

Struktur ini diikuti oleh daftar struktur PERF_COUNTER_DEFINITION , satu untuk setiap penghitung yang ditentukan untuk objek performa. Untuk detail tentang tata letak blok data performa, lihat Format Data Performa.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Header	winperf.h (termasuk Windows.h)

Lihat juga

PERF_COUNTER_DEFINITION

PERF_DATA_BLOCK

Format Data Performa

Bagikan melalui