struktur PERFORMANCE_DATA (winnt.h)

Berisi pembuatan profil utas dan data penghitung perangkat keras yang Anda minta.

Sintaks

typedef struct _PERFORMANCE_DATA {
  WORD                  Size;
  BYTE                  Version;
  BYTE                  HwCountersCount;
  DWORD                 ContextSwitchCount;
  DWORD64               WaitReasonBitMap;
  DWORD64               CycleTime;
  DWORD                 RetryCount;
  DWORD                 Reserved;
  HARDWARE_COUNTER_DATA HwCounters[MAX_HW_COUNTERS];
} PERFORMANCE_DATA, *PPERFORMANCE_DATA;

Anggota

Size

Ukuran struktur ini.

Version

Versi struktur ini. Harus diatur ke PERFORMANCE_DATA_VERSION.

HwCountersCount

Jumlah elemen array dalam array HwCounters yang berisi data penghitung perangkat keras. Nilai 3 berarti bahwa array berisi data untuk tiga penghitung perangkat keras, bukan elemen 0 hingga 2 berisi data penghitung.

ContextSwitchCount

Jumlah sakelar konteks yang terjadi sejak pembuatan profil diaktifkan.

WaitReasonBitMap

Bitmask yang mengidentifikasi alasan pengalihan konteks yang terjadi sejak terakhir kali data dibaca. Untuk nilai yang mungkin, lihat enumerasi KWAIT_REASON (enumerasi disertakan dalam file Wdm.h di WDK).

CycleTime

Waktu siklus utas (tidak termasuk waktu yang dihabiskan terganggu) sejak pembuatan profil waktu diaktifkan.

RetryCount

Berapa kali operasi baca membaca data untuk memastikan rekam jepret data yang konsisten.

Reserved

Dicadangkan. Atur ke nol.

HwCounters[MAX_HW_COUNTERS]

Array struktur HARDWARE_COUNTER_DATA yang berisi nilai penghitung. Elemen array yang berisi data penghitung terkait langsung dengan bit yang diatur dalam bitmask HardwareCounters yang Anda tentukan saat Anda memanggil fungsi EnableThreadProfiling . Misalnya, jika Anda mengatur bit 3 di bitmask HardwareCounters , HwCounters[3] akan berisi data penghitung untuk penghitung tersebut.

Keterangan

Anda harus menginisialisasi anggota Ukuran dan Versi sebelum memanggil fungsi ReadThreadProfilingData untuk membaca data pembuatan profil.

Data profil yang terkandung dalam struktur ini tergantung pada data yang Anda minta saat Anda memanggil fungsi ReadThreadProfilingData . Anggota berikut diatur saat Anda menentukan bendera READ_THREAD_PROFILING_FLAG_DISPATCHING:

• ContextSwitchCount
• CycleTime
• RetryCount
• WaitReasonBitMap

• HwCounters
• HwCountersCount

Persyaratan

Lihat juga

ReadThreadProfilingData