Bagikan melalui


enumerasi TDH_CONTEXT_TYPE (tdh.h)

Menentukan jenis konteks.

Sintaks

typedef enum _TDH_CONTEXT_TYPE {
  TDH_CONTEXT_WPP_TMFFILE,
  TDH_CONTEXT_WPP_TMFSEARCHPATH,
  TDH_CONTEXT_WPP_GMT,
  TDH_CONTEXT_POINTERSIZE,
  TDH_CONTEXT_PDB_PATH,
  TDH_CONTEXT_MAXIMUM
} TDH_CONTEXT_TYPE;

Konstanta

 
TDH_CONTEXT_WPP_TMFFILE
Untai (karakter) Unicode null-terminated yang berisi nama file .tmf yang digunakan untuk mengurai log WPP. Biasanya, nama file .tmf diambil dari GUID peristiwa sehingga Anda tidak perlu menentukan nama file.
TDH_CONTEXT_WPP_TMFSEARCHPATH
Untai (karakter) Unicode null-terminated yang berisi jalur ke file .tmf. Anda tidak perlu menentukan jalur ini jika jalur pencarian berisi file. Hanya tentukan informasi konteks ini jika Anda juga menentukan jenis konteks TDH_CONTEXT_WPP_TMFFILE. Jika file tidak ditemukan, TDH mencari lokasi berikut dalam urutan tertentu:


  • Jalur yang ditentukan dalam variabel lingkungan TRACE_FORMAT_SEARCH_PATH

  • Folder saat ini

TDH_CONTEXT_WPP_GMT
Bendera Boolean 1-byte yang menunjukkan apakah stempel waktu peristiwa WPP harus dikonversi ke Universal Time Coordinate (UTC). Jika 1, stempel waktu dikonversi ke UTC. Jika 0, stempel waktu berada di waktu setempat. Secara default, stempel waktu berada di waktu lokal.
TDH_CONTEXT_POINTERSIZE
Ukuran, dalam byte, dari jenis data penunjuk atau size_t jenis data yang digunakan dalam peristiwa tersebut. Menunjukkan apakah peristiwa menggunakan nilai 4-byte atau 8-byte. Secara default, ukuran penunjuk adalah ukuran penunjuk komputer pendekodean.

Untuk menentukan ukuran penunjuk atau nilai size_t, gunakan anggota PointerSizedari TRACE_LOGFILE_HEADER (peristiwa pertama yang Anda terima di panggilan balik EventRecordCallback Anda berisi header ini di bagian data). Namun, nilai ini mungkin tidak akurat. Misalnya, pada komputer 64-bit, aplikasi 32-bit akan mencatat pointer 4-byte; namun, sesi akan mengatur PointerSize ke 8.
TDH_CONTEXT_PDB_PATH
Untai (karakter) Unicode null-terminated yang berisi nama file .pdb untuk biner yang berisi pesan WPP. Parameter ini dapat digunakan sebagai alternatif untuk TDH_CONTEXT_WPP_TMFFILE atau TDH_CONTEXT_WPP_TMFSEARCHPATH.

Catatan Hanya tersedia untuk Windows 8 dan Windows Server 2012.

 
TDH_CONTEXT_MAXIMUM
Dicadangkan.

Keterangan

Jika Anda menentukan informasi konteks untuk peristiwa ETW warisan, Anda hanya perlu menentukan jenis TDH_CONTEXT_POINTERSIZE—jenis lain digunakan untuk peristiwa WPP dan diabaikan untuk peristiwa ETW warisan.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2008 [hanya aplikasi desktop]
Header tdh.h

Lihat juga

TDH_CONTEXT