Fungsi TraceSetInformation (evntrace.h)
Fungsi TraceSetInformation mengonfigurasi pengaturan sesi pelacakan peristiwa.
Sintaks
ULONG WMIAPI TraceSetInformation(
CONTROLTRACE_ID TraceId,
[in] TRACE_INFO_CLASS InformationClass,
[in] PVOID TraceInformation,
[in] ULONG InformationLength
);
Parameter
TraceId
[in] InformationClass
Kelas informasi untuk mengaktifkan atau menonaktifkan. Informasi yang diambil kelas disertakan di bagian data yang diperluas dari peristiwa tersebut. Untuk daftar kelas informasi yang dapat Anda aktifkan, lihat enumerasi TRACE_QUERY_INFO_CLASS .
[in] TraceInformation
Penunjuk ke data spesifik kelas informasi. Kelas informasi menentukan konten parameter ini.
[in] InformationLength
Ukuran, dalam byte, data dalam buffer TraceInformation .
Mengembalikan nilai
Jika fungsi berhasil, nilai yang dikembalikan adalah ERROR_SUCCESS.
Jika fungsi gagal, nilai yang dikembalikan adalah salah satu kode kesalahan berikut.
ERROR_BAD_LENGTH
Program mengeluarkan perintah tetapi panjang perintah salah. Kesalahan ini dikembalikan jika parameter InformationLength kurang dari ukuran minimum.
ERROR_INVALID_PARAMETER
Parameter salah.
ERROR_NOT_SUPPORTED
Permintaan tidak didukung.
Lainnya
Gunakan FormatMessage untuk mendapatkan string pesan untuk kesalahan yang dikembalikan.
Keterangan
Panggil fungsi ini setelah memanggil StartTrace.
Jika parameter InformationClass diatur ke TraceStackTracingInfo, memanggil fungsi ini memungkinkan pelacakan tumpukan peristiwa kernel yang ditentukan. Panggilan berikutnya ke fungsi ini menimpa daftar peristiwa kernel sebelumnya yang pelacakan tumpukannya diaktifkan. Untuk menonaktifkan pelacakan tumpukan, panggil fungsi ini dengan InformationClass yang diatur ke TraceStackTracingInfo dan InformationLength diatur ke 0.
Bagian data yang diperluas dari peristiwa akan menyertakan tumpukan panggilan. Kelas StackWalk_Event MOF menentukan tata letak data yang diperluas.
Biasanya, pada komputer 64-bit, Anda tidak dapat menangkap tumpukan kernel dalam konteks tertentu ketika kesalahan halaman tidak diizinkan. Untuk mengaktifkan berjalan tumpukan kernel pada x64, atur DisablePagingExecutive
nilai registri Manajemen Memori ke 1. Nilai DisablePagingExecutive
registri terletak di bawah kunci registri berikut: HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Session Manager\Memory Management
.
Ini hanya boleh dilakukan untuk tujuan diagnosis sementara karena meningkatkan penggunaan memori sistem.
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 | evntrace.h |
Pustaka | Sechost.lib pada Windows 8.1 dan Windows Server 2012 R2; Advapi32.lib pada Windows 8, Windows Server 2012, Windows 7 dan Windows Server 2008 R2 |
DLL | Sechost.dll pada Windows 8.1 dan Windows Server 2012 R2; Advapi32.dll pada Windows 8, Windows Server 2012, Windows 7, dan Windows Server 2008 R2 |