Share via

struktur ENABLE_TRACE_PARAMETERS_V1 (evntrace.h)

  • Artikel

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

Lihat juga

ENABLE_TRACE_PARAMETERS

EVENT_FILTER_DESCRIPTOR

EnableTraceEx2