通过

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 结尾的 Unicode 字符串，其中包含用于分析 WPP 日志的 .tmf 文件的名称。 通常，.tmf 文件名是从事件 GUID 中选取的，因此无需指定文件名。
TDH_CONTEXT_WPP_TMFSEARCHPATH
以 Null 结尾的 Unicode 字符串，其中包含 .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值的大小，请使用TRACE_LOGFILE_HEADER的 PointerSize 成员 (EventRecordCallback 回调中收到的第一个事件，该事件包含数据部分) 中的此标头。 但是，此值可能不准确。 例如，在 64 位计算机上，32 位应用程序将记录 4 字节指针;但是，会话会将 PointerSize 设置为 8。
TDH_CONTEXT_PDB_PATH
以 Null 结尾的 Unicode 字符串，其中包含包含 WPP 消息的二进制文件的 .pdb 文件的名称。 此参数可用作 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