struktur ENABLE_TRACE_PARAMETERS_V1 (evntrace.h)
Struktur ENABLE_TRACE_PARAMETERS_V1 berisi informasi yang digunakan untuk mengaktifkan penyedia melalui EnableTraceEx2. Struktur ini usang. Gunakan ENABLE_TRACE_PARAMETERS sebagai gantinya.
Sintaks
typedef struct _ENABLE_TRACE_PARAMETERS_V1 {
ULONG Version;
ULONG EnableProperty;
ULONG ControlFlags;
GUID SourceId;
PEVENT_FILTER_DESCRIPTOR EnableFilterDesc;
} ENABLE_TRACE_PARAMETERS_V1, *PENABLE_TRACE_PARAMETERS_V1;
Anggota
Version
Atur ke ENABLE_TRACE_PARAMETERS_VERSION (1).
EnableProperty
Informasi opsional yang dapat disertakan ETW saat menulis acara. Data ditulis ke bagian item data yang diperluas dari peristiwa. Untuk menyertakan informasi opsional, tentukan satu atau beberapa bendera berikut; jika tidak, atur ke nol.
EVENT_ENABLE_PROPERTY_SID
Sertakan dalam data yang diperluas pengidentifikasi keamanan (SID) pengguna.
EVENT_ENABLE_PROPERTY_TS_ID
Sertakan dalam data yang diperluas pengidentifikasi sesi terminal.
EVENT_ENABLE_PROPERTY_STACK_TRACE
Tambahkan jejak tumpukan panggilan ke data acara yang diperluas yang ditulis menggunakan EventWrite.
Catatan
ETW akan menghilangkan peristiwa jika ukuran peristiwa total melebihi 64K. Jika penyedia mencatat peristiwa yang berukuran mendekati maksimum 64K, ada kemungkinan bahwa mengaktifkan pengambilan tumpukan akan menyebabkan peristiwa hilang.
Jika tumpukan lebih panjang dari jumlah maksimum bingkai (192), bingkai akan dipotong dari bagian bawah tumpukan.
Untuk konsumen, peristiwa akan mencakup item EVENT_EXTENDED_ITEM_STACK_TRACE32 atau EVENT_EXTENDED_ITEM_STACK_TRACE64 diperpanjang. Perhatikan bahwa konsumen 32-bit mungkin menerima jejak tumpukan 64-bit dari proses 64-bit.
ControlFlags
Dicadangkan. Atur ke 0.
SourceId
GUID yang secara unik mengidentifikasi pemanggil yang mengaktifkan atau menonaktifkan penyedia. Jika penyedia tidak menerapkan EnableCallback, GUID tidak digunakan.
EnableFilterDesc
Struktur EVENT_FILTER_DESCRIPTOR yang menunjuk ke data filter. Penyedia menggunakan data filter untuk mencegah peristiwa yang cocok dengan kriteria filter ditulis ke sesi. Penyedia menentukan tata letak data dan cara menerapkan filter ke data peristiwa. Sesi hanya dapat meneruskan satu filter ke penyedia.
Sesi dapat memanggil fungsi TdhEnumerateProviderFilters untuk menentukan filter skema yang dapat diteruskan ke penyedia.
Keterangan
ENABLE_TRACE_PARAMETERS_V1 sudah usang. Struktur ENABLE_TRACE_PARAMETERS adalah struktur versi 2 dan menggantikan struktur ENABLE_TRACE_PARAMETERS_V1 .
Biasanya, pada komputer 64-bit, Anda tidak dapat menangkap tumpukan kernel dalam konteks tertentu ketika kesalahan halaman tidak diizinkan. Untuk mengaktifkan berjalan di 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
Klien minimum yang didukung | Windows 7 [hanya aplikasi desktop] |
Server minimum yang didukung | Windows Server 2008 R2 [hanya aplikasi desktop] |
Header | evntrace.h |