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
WPP ログの解析に使用される .tmf ファイルの名前を含む Null で終わる Unicode 文字列。 通常、.tmf ファイル名はイベント GUID から取得されるため、ファイル名を指定する必要はありません。
TDH_CONTEXT_WPP_TMFSEARCHPATH
.tmf ファイルへのパスを含む Null で終わる Unicode 文字列。 検索パスにファイルが含まれている場合は、このパスを指定する必要はありません。 TDH_CONTEXT_WPP_TMFFILE コンテキストの種類も指定する場合にのみ、このコンテキスト情報を指定します。 ファイルが見つからない場合、TDH は指定された順序で次の場所を検索します。


  • TRACE_FORMAT_SEARCH_PATH環境変数で指定されたパス

  • 現在のフォルダー
TDH_CONTEXT_WPP_GMT
WPP イベント タイム スタンプを世界時座標 (UTC) に変換する必要があるかどうかを示す 1 バイトのブール型フラグ。 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
WPP メッセージを含むバイナリの .pdb ファイルの名前を含む Null で終わる Unicode 文字列。 このパラメーターは、 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 [デスクトップ アプリのみ]
Header tdh.h

こちらもご覧ください

TDH_CONTEXT