struktur PERF_DATA_BLOCK (winperf.h)

Artikel
08/27/2023

Menjelaskan blok data performa yang Anda kueri, misalnya, jumlah objek performa yang dikembalikan oleh penyedia dan nilai berbasis waktu yang Anda gunakan saat menghitung nilai performa.

Sintaks

typedef struct _PERF_DATA_BLOCK {
  WCHAR         Signature[4];
  DWORD         LittleEndian;
  DWORD         Version;
  DWORD         Revision;
  DWORD         TotalByteLength;
  DWORD         HeaderLength;
  DWORD         NumObjectTypes;
  LONG          DefaultObject;
  SYSTEMTIME    SystemTime;
  LARGE_INTEGER PerfTime;
  LARGE_INTEGER PerfFreq;
  LARGE_INTEGER PerfTime100nSec;
  DWORD         SystemNameLength;
  DWORD         SystemNameOffset;
} PERF_DATA_BLOCK, *PPERF_DATA_BLOCK;

Anggota

Signature[4]

Array empat karakter lebar yang berisi "PERF".

LittleEndian

Menunjukkan apakah nilai penghitung dalam format big endian atau format little endian. Jika satu, nilai penghitung dalam format little endian. Jika nol, nilai penghitung dalam format big endian. Nilai ini mungkin nol (format big endian) jika Anda mengambil data performa dari komputer asing, seperti komputer UNIX.

Version

Versi struktur performa.

Revision

Revisi struktur performa.

TotalByteLength

Ukuran total blok data performa, dalam byte.

HeaderLength

Ukuran struktur ini, dalam byte. Anda menggunakan panjang header untuk menemukan struktur PERF_OBJECT_TYPE pertama di blok data performa.

NumObjectTypes

Jumlah objek performa di blok data performa.

DefaultObject

Dicadangkan.

SystemTime

Waktu ketika sistem dipantau. Anggota ini dalam format Waktu Universal Terkoordinasi (UTC).

PerfTime

Nilai penghitung kinerja, dalam hitungan, untuk sistem yang sedang dipantau. Untuk informasi selengkapnya, lihat QueryPerformanceCounter.

PerfFreq

Frekuensi penghitung kinerja, dalam hitungan per detik, untuk sistem yang sedang dipantau. Untuk informasi selengkapnya, lihat QueryPerformanceFrequency.

PerfTime100nSec

Nilai penghitung kinerja, dalam 100 unit nanodetik, untuk sistem yang sedang dipantau. Untuk informasi selengkapnya, lihat GetSystemTimeAsFileTime.

SystemNameLength

Ukuran nama komputer yang terletak di SystemNameOffset, dalam byte.

SystemNameOffset

Offset dari awal struktur ini ke nama Unicode komputer yang sedang dipantau.

Keterangan

Blok data performa dikembalikan saat konsumen memanggil RegQueryValueEx untuk mengambil satu atau beberapa objek performa. Struktur ini adalah struktur pertama dalam blok yang dikembalikan. Struktur berikutnya dalam blok adalah struktur PERF_OBJECT_TYPE , yang menentukan objek performa. Untuk detail tentang tata letak blok data performa, lihat Format Data Performa.

Konsumen menggunakan PerfTime, PerfFreq, dan PerfTime100nSec saat menghitung nilai penghitung kecuali jenis penghitung berisi bendera PERF_OBJECT_TIMER dalam hal ini konsumen menggunakan anggota PerfTime dan PerfFreqPERF_OBJECT_TYPE.

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

Format Data Performa

Bagikan melalui