Win32 API 日本語リファレンス
ホームSystem.Diagnostics.Etw › TDH_CONTEXT_TYPE

TDH_CONTEXT_TYPE

列挙型
基底型i4

メンバー 6

名前10進16進説明
TDH_CONTEXT_WPP_TMFFILE00x0WPP ログの解析に使用する .tmf ファイルの名前を格納した、NULL 終端の Unicode 文字列です。通常、.tmf ファイル名はイベントの GUID から取得されるため、ファイル名を指定する必要はありません。
TDH_CONTEXT_WPP_TMFSEARCHPATH10x1

.tmf ファイルへのパスを格納した、NULL 終端の Unicode 文字列です。検索パスにこのファイルが含まれている場合は、このパスを指定する必要はありません。このコンテキスト情報は、TDH_CONTEXT_WPP_TMFFILE コンテキストの種類も指定する場合にのみ指定してください。ファイルが見つからない場合、TDH は次の場所を記載された順序で検索します。

  • TRACE_FORMAT_SEARCH_PATH 環境変数に指定されたパス
  • 現在のフォルダー
TDH_CONTEXT_WPP_GMT20x2WPP イベントのタイムスタンプを協定世界時 (UTC) に変換するかどうかを示す、1 バイトのブール値フラグです。1 の場合、タイムスタンプは UTC に変換されます。0 の場合、タイムスタンプはローカル時刻になります。既定では、タイムスタンプはローカル時刻です。
TDH_CONTEXT_POINTERSIZE30x3

イベントで使用されるポインター型または size_t 型のサイズ (バイト単位) です。イベントが 4 バイト値と 8 バイト値のどちらを使用したかを示します。既定では、ポインターのサイズはデコードを行うコンピューターのポインターのサイズになります。

ポインターまたは size_t 値のサイズを判断するには、TRACE_LOGFILE_HEADERPointerSize メンバーを使用します (EventRecordCallback コールバックで最初に受け取るイベントのデータ セクションに、このヘッダーが含まれます)。ただし、この値は正確でない場合があります。たとえば、64 ビット コンピューターでは、32 ビット アプリケーションは 4 バイトのポインターをログに記録しますが、セッションは PointerSize を 8 に設定します。

TDH_CONTEXT_PDB_PATH40x4

WPP メッセージを含むバイナリの .pdb ファイルの名前を格納した、NULL 終端の Unicode 文字列です。このパラメーターは、TDH_CONTEXT_WPP_TMFFILE または TDH_CONTEXT_WPP_TMFSEARCHPATH の代わりに使用できます。

メモ Windows 8 および Windows Server 2012 でのみ使用できます。
TDH_CONTEXT_MAXIMUM50x5予約済みです。

公式ドキュメント

コンテキストの種類を定義します。

解説(Remarks)

従来の ETW イベントに対してコンテキスト情報を指定する場合は、TDH_CONTEXT_POINTERSIZE 型のみを指定すれば十分です。他の種類は WPP イベント用であり、従来の ETW イベントでは無視されます。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での定義

列挙メンバーの定義。HSP タブは #define global(値は16進)。

typedef enum TDH_CONTEXT_TYPE : int {
    TDH_CONTEXT_WPP_TMFFILE = 0,
    TDH_CONTEXT_WPP_TMFSEARCHPATH = 1,
    TDH_CONTEXT_WPP_GMT = 2,
    TDH_CONTEXT_POINTERSIZE = 3,
    TDH_CONTEXT_PDB_PATH = 4,
    TDH_CONTEXT_MAXIMUM = 5
} TDH_CONTEXT_TYPE;
public enum TDH_CONTEXT_TYPE : int
{
    TDH_CONTEXT_WPP_TMFFILE = 0,
    TDH_CONTEXT_WPP_TMFSEARCHPATH = 1,
    TDH_CONTEXT_WPP_GMT = 2,
    TDH_CONTEXT_POINTERSIZE = 3,
    TDH_CONTEXT_PDB_PATH = 4,
    TDH_CONTEXT_MAXIMUM = 5,
}
Public Enum TDH_CONTEXT_TYPE As Integer
    TDH_CONTEXT_WPP_TMFFILE = 0
    TDH_CONTEXT_WPP_TMFSEARCHPATH = 1
    TDH_CONTEXT_WPP_GMT = 2
    TDH_CONTEXT_POINTERSIZE = 3
    TDH_CONTEXT_PDB_PATH = 4
    TDH_CONTEXT_MAXIMUM = 5
End Enum
import enum

class TDH_CONTEXT_TYPE(enum.IntEnum):
    TDH_CONTEXT_WPP_TMFFILE = 0
    TDH_CONTEXT_WPP_TMFSEARCHPATH = 1
    TDH_CONTEXT_WPP_GMT = 2
    TDH_CONTEXT_POINTERSIZE = 3
    TDH_CONTEXT_PDB_PATH = 4
    TDH_CONTEXT_MAXIMUM = 5
// TDH_CONTEXT_TYPE
pub const TDH_CONTEXT_WPP_TMFFILE: i32 = 0;
pub const TDH_CONTEXT_WPP_TMFSEARCHPATH: i32 = 1;
pub const TDH_CONTEXT_WPP_GMT: i32 = 2;
pub const TDH_CONTEXT_POINTERSIZE: i32 = 3;
pub const TDH_CONTEXT_PDB_PATH: i32 = 4;
pub const TDH_CONTEXT_MAXIMUM: i32 = 5;
// TDH_CONTEXT_TYPE
const (
	TDH_CONTEXT_WPP_TMFFILE int32 = 0
	TDH_CONTEXT_WPP_TMFSEARCHPATH int32 = 1
	TDH_CONTEXT_WPP_GMT int32 = 2
	TDH_CONTEXT_POINTERSIZE int32 = 3
	TDH_CONTEXT_PDB_PATH int32 = 4
	TDH_CONTEXT_MAXIMUM int32 = 5
)
const
  TDH_CONTEXT_WPP_TMFFILE = 0;
  TDH_CONTEXT_WPP_TMFSEARCHPATH = 1;
  TDH_CONTEXT_WPP_GMT = 2;
  TDH_CONTEXT_POINTERSIZE = 3;
  TDH_CONTEXT_PDB_PATH = 4;
  TDH_CONTEXT_MAXIMUM = 5;
// TDH_CONTEXT_TYPE
pub const TDH_CONTEXT_WPP_TMFFILE: i32 = 0;
pub const TDH_CONTEXT_WPP_TMFSEARCHPATH: i32 = 1;
pub const TDH_CONTEXT_WPP_GMT: i32 = 2;
pub const TDH_CONTEXT_POINTERSIZE: i32 = 3;
pub const TDH_CONTEXT_PDB_PATH: i32 = 4;
pub const TDH_CONTEXT_MAXIMUM: i32 = 5;
const
  TDH_CONTEXT_WPP_TMFFILE* = 0
  TDH_CONTEXT_WPP_TMFSEARCHPATH* = 1
  TDH_CONTEXT_WPP_GMT* = 2
  TDH_CONTEXT_POINTERSIZE* = 3
  TDH_CONTEXT_PDB_PATH* = 4
  TDH_CONTEXT_MAXIMUM* = 5
enum TDH_CONTEXT_TYPE : int {
    TDH_CONTEXT_WPP_TMFFILE = 0,
    TDH_CONTEXT_WPP_TMFSEARCHPATH = 1,
    TDH_CONTEXT_WPP_GMT = 2,
    TDH_CONTEXT_POINTERSIZE = 3,
    TDH_CONTEXT_PDB_PATH = 4,
    TDH_CONTEXT_MAXIMUM = 5,
}
#define global TDH_CONTEXT_WPP_TMFFILE       0x0
#define global TDH_CONTEXT_WPP_TMFSEARCHPATH 0x1
#define global TDH_CONTEXT_WPP_GMT           0x2
#define global TDH_CONTEXT_POINTERSIZE       0x3
#define global TDH_CONTEXT_PDB_PATH          0x4
#define global TDH_CONTEXT_MAXIMUM           0x5