Share via

TDH_CONTEXT_TYPE列舉 (tdh.h)

  • 發行項

定義內容類型。

Syntax

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