struktur PERF_COUNTERSET_INFO (perflib.h)

Artikel
03/08/2023

Menentukan informasi tentang set penghitung yang digunakan penyedia. Alat CTRPP secara otomatis menghasilkan struktur ini berdasarkan skema yang Anda tentukan.

Sintaks

typedef struct _PERF_COUNTERSET_INFO {
  GUID  CounterSetGuid;
  GUID  ProviderGuid;
  ULONG NumCounters;
  ULONG InstanceType;
} PERF_COUNTERSET_INFO, *PPERF_COUNTERSET_INFO;

Anggota

CounterSetGuid

GUID yang secara unik mengidentifikasi set penghitung. Atribut guid dari elemen counterSet berisi GUID.

ProviderGuid

GUID yang secara unik mengidentifikasi penyedia yang mendukung set penghitung. Atribut providerGuid dari elemen penyedia berisi GUID.

NumCounters

Jumlah penghitung dalam set penghitung. Lihat Keterangan.

InstanceType

Menentukan apakah set penghitung memungkinkan beberapa instans seperti proses dan disk fisik, atau satu instans seperti memori.

Berikut ini adalah jenis instans yang mungkin.

Nilai	Makna
PERF_COUNTERSET_SINGLE_INSTANCE	Set penghitung berisi penghitung instans tunggal, misalnya, penghitung yang mengukur memori fisik.
PERF_COUNTERSET_MULTI_INSTANCES	Set penghitung berisi beberapa penghitung instans, misalnya, penghitung yang mengukur I/O disk rata-rata untuk proses.
PERF_COUNTERSET_SINGLE_AGGREGATE	Set penghitung berisi penghitung instans tunggal yang nilai agregatnya diperoleh dari satu atau beberapa sumber. Misalnya, penghitung dalam jenis set penghitung ini mungkin mendapatkan jumlah bacaan dari masing-masing dari tiga hard disk di komputer dan menjumlahkan nilainya.
PERF_COUNTERSET_MULTI_AGGREGATE	Set penghitung berisi beberapa penghitung instans yang nilai agregatnya diperoleh dari semua instans penghitung. Misalnya, penghitung dalam jenis set penghitung ini mungkin mendapatkan total waktu eksekusi utas untuk semua utas dalam aplikasi multi-utas dan menjumlahkan nilainya.
PERF_COUNTERSET_SINGLE_AGGREGATE_HISTORY	Perbedaan antara jenis ini dan PERF_COUNTERSET_SINGLE_AGGREGATE adalah bahwa jenis set penghitung ini menyimpan semua nilai penghitung selama masa pakai aplikasi konsumen (nilai penghitung di-cache di luar masa pakai penghitung). Misalnya, jika salah satu hard disk dalam satu contoh agregat di atas menjadi tidak tersedia, total byte yang dibaca oleh disk tersebut masih akan tersedia dan digunakan untuk menghitung nilai agregat.
PERF_COUNTERSET_INSTANCE_AGGREGATE	Jenis ini mirip dengan PERF_COUNTERSET_MULTI_AGGREGATE, kecuali bahwa alih-alih menggabungkan semua data instans ke satu instans agregat (_Total), instans tersebut akan menggabungkan data penghitung dari instans dengan nama yang sama. Misalnya, jika beberapa proses penyedia berisi instans bernama IExplore, PERF_COUNTERSET_MULTIPLE dan PERF_COUNTERSET_MULTI_AGGREGATE CounterSet akan menampilkan beberapa instans IExplore (IExplore, IExplore#1, IExplore#2, dan sebagainya); namun, jenis instans PERF_COUNTERSET_INSTANCE_AGGREGATE hanya akan menerbitkan satu instans IExplore dengan data penghitung agregat dari semua instans bernama IExplore. Windows Vista: Tipe ini tidak tersedia.

Keterangan

Blok memori untuk struktur ini juga berisi satu atau beberapa struktur PERF_COUNTER_INFO . Anggota NumCounter menentukan jumlah struktur PERF_COUNTER_INFO yang mengikuti struktur ini dalam memori.

Persyaratan


Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Header	perflib.h

Lihat juga

PERF_COUNTER_INFO

PerfSetCounterSetInfo

Bagikan melalui