struktur PERF_INSTANCE_DEFINITION (winperf.h)

Artikel
08/27/2023

Menjelaskan instans objek performa.

Sintaks

typedef struct _PERF_INSTANCE_DEFINITION {
  DWORD ByteLength;
  DWORD ParentObjectTitleIndex;
  DWORD ParentObjectInstance;
  LONG  UniqueID;
  DWORD NameOffset;
  DWORD NameLength;
} PERF_INSTANCE_DEFINITION, *PPERF_INSTANCE_DEFINITION;

Anggota

ByteLength

Ukuran struktur ini, termasuk nama instans yang mengikuti, dalam byte. Nilai ini harus kelipatan 8-byte.

ParentObjectTitleIndex

Indeks nama objek induk dalam database judul. Misalnya, jika objek adalah utas, objek induk adalah proses, atau jika objek adalah drive logis, induknya adalah drive fisik.

ParentObjectInstance

Posisi instans dalam objek induk yang terkait dengan instans ini. Posisinya berbasis nol.

UniqueID

Pengidentifikasi unik yang dapat Anda gunakan untuk mengidentifikasi instans alih-alih menggunakan nama untuk mengidentifikasi instans. Jika Anda tidak menggunakan pengidentifikasi unik untuk membedakan instans penghitung, atur anggota ini ke PERF_NO_UNIQUE_ID.

NameOffset

Offset dari awal struktur ini ke nama Unicode instans ini.

NameLength

Panjang nama instans, termasuk null-terminator, dalam byte. Anggota ini nol jika instans tidak memiliki nama.

Jangan sertakan panjang padding apa pun yang Anda tambahkan ke nama instans untuk memastikan bahwa ByteLength selaras dengan batas 8-byte.

Keterangan

Objek berisi instans jika anggota NumInstancesPERF_OBJECT_TYPE lebih besar dari nol. Gunakan anggota DefinitionLengthdari PERF_OBJECT_TYPE untuk menemukan instans pertama objek. Untuk detailnya, lihat Format Data Performa.

Konsumen harus menggunakan nama instans induk, jika ditentukan, untuk membuat nama instans lengkap yang digunakan untuk tampilan. Konvensinya adalah membentuk nama sebagai induk/anak.

Penyedia harus menggunakan nama instans unik. Jika tidak, menyulitkan konsumen untuk menghitung dan menampilkan nilai performa karena mereka tidak dapat mengetahui apakah instans saat ini mengacu pada instans yang sama yang dikueri sebelumnya (instans dapat datang dan pergi).

Penyedia harus mengalokasikan cukup ruang untuk nama instans untuk memastikan bahwa ByteLength selaras dengan batas 8-byte.

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_OBJECT_TYPE

Bagikan melalui