Поделиться через

перечисление TDH_CONTEXT_TYPE (tdh.h)

  • Статья

Определяет тип контекста.

Синтаксис

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;

Константы

 
TDH_CONTEXT_WPP_TMFFILE
Строка Юникода, завершающаяся null, которая содержит имя TMF-файла, используемого для синтаксического анализа журнала WPP. Как правило, имя TMF-файла берется из GUID события, поэтому указывать имя файла не нужно.
TDH_CONTEXT_WPP_TMFSEARCHPATH
Строка Юникода, завершающаяся null, которая содержит путь к TMF-файлу. Этот путь указывать не нужно, если путь поиска содержит файл. Укажите эти сведения о контексте, только если также указан тип контекста TDH_CONTEXT_WPP_TMFFILE. Если файл не найден, TDH выполняет поиск в следующих расположениях в указанном порядке:


  • Путь, указанный в переменной среды TRACE_FORMAT_SEARCH_PATH

  • Текущая папка
TDH_CONTEXT_WPP_GMT
1-байтовый логический флаг, указывающий, следует ли преобразовать метку времени события WPP в универсальную координату времени (UTC). Если значение равно 1, метка времени преобразуется в формат UTC. Если значение равно 0, метка времени указана по местному времени. По умолчанию метка времени указана в местном времени.
TDH_CONTEXT_POINTERSIZE
Размер в байтах типов данных указателя или size_t типов данных, используемых в событии. Указывает, использовало ли событие 4-байтовые или 8-байтовые значения. По умолчанию размер указателя равен размеру указателя компьютера для декодирования.

Чтобы определить размер значения указателя или size_t, используйте элемент PointerSizeTRACE_LOGFILE_HEADER (первое событие, которое вы получаете в обратном вызове EventRecordCallback , содержит этот заголовок в разделе данных). Однако это значение может быть неверным. Например, на 64-разрядном компьютере 32-разрядное приложение регистрирует 4-байтовые указатели; однако сеанс установит для параметра PointerSize значение 8.
TDH_CONTEXT_PDB_PATH
Строка Юникода, завершающаяся null, которая содержит имя PDB-файла для двоичного файла, содержащего сообщения WPP. Этот параметр можно использовать в качестве альтернативы TDH_CONTEXT_WPP_TMFFILE или TDH_CONTEXT_WPP_TMFSEARCHPATH.

Примечание Доступно только для Windows 8 и Windows Server 2012.

 
TDH_CONTEXT_MAXIMUM
Зарезервировано.

Комментарии

Если вы указываете сведения о контексте для устаревшего события ETW, необходимо указать только тип TDH_CONTEXT_POINTERSIZE. Другие типы используются для событий WPP и игнорируются для устаревших событий ETW.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Верхняя часть tdh.h

См. также раздел

TDH_CONTEXT