Fungsi EnableThreadProfiling (winbase.h)

Mengaktifkan pembuatan profil utas pada utas yang ditentukan.

Sintaks

DWORD EnableThreadProfiling(
  [in]  HANDLE  ThreadHandle,
  [in]  DWORD   Flags,
  [in]  DWORD64 HardwareCounters,
  [out] HANDLE  *PerformanceDataHandle
);

Parameter

[in] ThreadHandle

Handel ke utas tempat Anda ingin mengaktifkan pembuatan profil. Ini harus menjadi utas saat ini.

[in] Flags

Untuk menerima data pembuatan profil utas seperti jumlah pengalihan konteks, atur parameter ini ke THREAD_PROFILING_FLAG_DISPATCH; jika tidak, atur ke 0.

[in] HardwareCounters

Untuk menerima data penghitung kinerja perangkat keras, atur parameter ini ke bitmask yang mengidentifikasi penghitung perangkat keras yang akan dikumpulkan. Anda dapat menentukan hingga 16 penghitung kinerja. Setiap bit berkaitan langsung dengan indeks penghitung perangkat keras berbasis nol untuk penghitung kinerja perangkat keras yang Anda konfigurasikan. Atur ke nol jika Anda tidak mengumpulkan data penghitung perangkat keras. Jika Anda mengatur sedikit untuk penghitung perangkat keras yang belum dikonfigurasi, nilai penghitung yang dibaca untuk penghitung tersebut adalah nol.

[out] PerformanceDataHandle

Handel buram yang Anda gunakan saat memanggil fungsi ReadThreadProfilingData dan DisableThreadProfiling .

Nilai kembali

Mengembalikan ERROR_SUCCESS jika panggilan berhasil; jika tidak, kode kesalahan sistem (lihat Winerror.h).

Keterangan

Anda harus memanggil fungsi DisableThreadProfiling sebelum keluar dari utas.

Untuk memprofilkan penghitung kinerja perangkat keras, Anda memerlukan driver untuk mengonfigurasi penghitung. Penghitung kinerja dikonfigurasi secara global untuk sistem, sehingga setiap utas memiliki akses ke data penghitung perangkat keras yang sama. Penghitung harus dikonfigurasi sebelum Anda mengaktifkan pembuatan profil. Untuk informasi tentang mengonfigurasi penghitung kinerja perangkat keras, lihat fungsi KeSetHardwareCounterConfiguration di Windows Driver Kit (WDK).

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 R2 [hanya aplikasi desktop]
Target Platform	Windows
Header	winbase.h (termasuk Windows.h)
Pustaka	Kernel32.lib
DLL	Kernel32.dll

Lihat juga

DisableThreadProfiling

QueryThreadProfiling

ReadThreadProfilingData