EnumerateTraceGuidsEx、TraceQueryInformation、または TraceSetInformation と共に使用して、トレース情報の種類を指定します。
TRACE_INFO_CLASSとTRACE_QUERY_INFO_CLASSは、同じ列挙体の typedef であることに注意してください。
列挙型の値を使用する必要がある API に関するより包括的なドキュメントと、対応するバッファーの入力形式と出力形式は、 evntrace.hの列挙定義でインラインでTRACE_QUERY_INFO_CLASS使用できます。
構文
typedef enum _TRACE_QUERY_INFO_CLASS {
TraceGuidQueryList = 0,
TraceGuidQueryInfo = 1,
TraceGuidQueryProcess = 2,
TraceStackTracingInfo = 3,
TraceSystemTraceEnableFlagsInfo = 4,
TraceSampledProfileIntervalInfo = 5,
TraceProfileSourceConfigInfo = 6,
TraceProfileSourceListInfo = 7,
TracePmcEventListInfo = 8,
TracePmcCounterListInfo = 9,
TraceSetDisallowList = 10,
TraceVersionInfo = 11,
TraceGroupQueryList = 12,
TraceGroupQueryInfo = 13,
TraceDisallowListQuery = 14,
TraceInfoReserved15,
TracePeriodicCaptureStateListInfo = 16,
TracePeriodicCaptureStateInfo = 17,
TraceProviderBinaryTracking = 18,
TraceMaxLoggersQuery = 19,
TraceLbrConfigurationInfo = 20,
TraceLbrEventListInfo = 21,
TraceMaxPmcCounterQuery = 22,
TraceStreamCount = 23,
TraceStackCachingInfo = 24,
TracePmcCounterOwners = 25,
TraceUnifiedStackCachingInfo = 26,
TracePmcSessionInformation = 27,
TraceContextRegisterInfo = 28,
MaxTraceSetInfoClass = 29
} TRACE_QUERY_INFO_CLASS, TRACE_INFO_CLASS;
定数
TraceGuidQueryList値: 0 に登録されているプロバイダーの GUID の配列を照会します。 配置を使用する。 |
TraceGuidQueryInfo値: 1 各セッションがプロバイダーを有効にするために使用した情報を照会します。 |
TraceGuidQueryProcess値: 2 に自身を登録したプロバイダーの GUID の配列を照会します。 呼び出し元プロセスと同じプロセス。 |
TraceStackTracingInfo値: 3 カーネル イベントの呼び出し履歴トレースの設定を照会します。 CLASSIC_EVENT_IDの配列を返します。 構造を示しています。 構造体は、スタック トレースの対象となるイベント GUID を指定します。 。 配列は 256 個の要素に制限されています。 この値は、Windows 7、Windows Server 2008 R2 以降でサポートされています。 |
TraceSystemTraceEnableFlagsInfo値: 4 システム トレース プロバイダーの EnableFlags の設定を照会します。 For 詳細については、次を参照してください。 EVENT_TRACE_PROPERTIES 構造体。 この値は、Windows 8、Windows Server 2012 以降でサポートされています。 |
TraceSampledProfileIntervalInfo値: 5 指定されたソースのサンプリング プロファイル間隔の設定を照会します。 この値は、Windows 8、Windows Server 2012 以降でサポートされています。 |
TraceProfileSourceConfigInfo値: 6 の実行時に収集されるプロファイリング ソースの一覧を構成します。 パフォーマンス監視カウンター プロファイル イベントが発生します。 収集されたカウンターは、 は、イベントの PERF_PMC_PROFILE 一部として生成されます。この値は、Windows 8、Windows Server 2012 以降でサポートされています。 |
TraceProfileSourceListInfo値: 7 システムで使用可能なプロファイリング ソースの一覧を照会します。 この値は、Windows 8、Windows Server 2012 以降でサポートされています。 |
TracePmcEventListInfo値: 8 パフォーマンスの対象となるシステム イベントの一覧を使用してセッションを構成します によって TracePmcCounterListInfo 構成された監視カウンターが収集されます。この値は、Windows 8、Windows Server 2012 以降でサポートされています。 |
TracePmcCounterListInfo値: 9 収集されるプロファイリング ソースの一覧を使用してセッションを構成します によって TracePmcEventListInfo 構成されたイベントがセッションにログに記録される場合。この値は、Windows 8、Windows Server 2012 以降でサポートされています。 |
TraceSetDisallowList値: 10 の一部としてこのセッションに対して有効にならないプロバイダーの一覧を設定します。 プロバイダー グループの有効化。 詳細については、「 プロバイダーの特徴。 この値は、Windows 10、Windows Server 2016 以降でサポートされています。 |
TraceVersionInfo値: 11 トレース ファイルのバージョン情報を照会します。 この値は、Windows 10、Windows Server 2016 以降でサポートされています。 |
TraceGroupQueryList値: 12 コンピューター上でアクティブなプロバイダー グループの GUID の配列に対してクエリを実行します。 |
TraceGroupQueryInfo値: 13 この値は、Windows 10、Windows Server 2016 以降でサポートされています。 各セッションがプロバイダー グループを有効にするために使用した情報を照会します。 |
TraceDisallowListQuery値: 14 この値は、Windows 10、Windows Server 2016 以降でサポートされています。 このセッションで有効になっているグループに対して許可されていない GUID の配列に対してクエリを実行します。 この値は、Windows 10、Windows Server 2016 以降でサポートされています。 |
TraceInfoReserved15将来利用するために予約されています。 使用しないでください。 |
TracePeriodicCaptureStateListInfo値: 16 定期的にを受信するプロバイダーの一覧を使用してセッションを更新します。 EVENT_CONTROL_CODE_CAPTURE_STATE からの呼び出しと同じ方法でコードを制御するEnableTraceEx2。 詳細については、「 TRACE_PERIODIC_CAPTURE_STATE_INFO。 この値は、Windows 10 バージョン 1709、Windows Server、バージョンでサポートされています 1709 以降。 |
TracePeriodicCaptureStateInfo値: 17 システム上の定期的なキャプチャ状態設定の制限に対してクエリを実行します。 可能なプロバイダーの最小時間頻度と最大数 同時に構成されます。 詳細については、「 TRACE_PERIODIC_CAPTURE_STATE_INFO。 この値は、Windows 10 バージョン 1709、Windows Server、バージョンでサポートされています 1709 以降。 |
TraceProviderBinaryTracking値: 18 有効になっているすべてのプロバイダーのバイナリの追跡を開始するように ETW に指示します。 セッション。 追跡は、セッションで有効になっているプロバイダーに適用されます 呼び出し時だけでなく、有効になっている将来のすべてのプロバイダーに対して、 セッション。 ETW は、プロバイダー GUID 間のマッピングを含む追跡イベントを生成します と、追跡対象プロバイダーのコールバックを含むモジュールへのパス。 / リアルタイム セッションの場合、イベントはリアルタイムでライブで提供されます バッファー。 ファイル ベースのセッションの場合 (つまり、トレースが に保存されている場合) .etl ファイル)、イベントが集計され、ファイル ヘッダーに書き込まれます。彼らは は、ETW ランタイムが .etl ファイルの再生時に提供する最初のイベントの 1 つです 戻る。 バイナリ追跡イベントには、プロバイダー ID EventTraceGuid とオペコードが含まれます0x43.この値は、Windows 10 バージョン 1709、Windows Server、バージョンでサポートされています 1709 以降。 |
TraceMaxLoggersQuery値: 19 現在構成されている ETW ログ セッションの最大数を照会します。 オペレーティング システムによって。 ULONG を返します。 次と共に使用します: EnumerateTraceGuidsEx。 この値は、Windows 10 バージョン 1709、Windows Server、バージョンでサポートされています 1709 以降。 |
TraceLbrConfigurationInfo値: 20 特定のセッションに対して Last Branch Record トレースを有効にし、 対応する LBR フィルター。 この値は、Windows 10 バージョン 19H1、Windows Server、バージョンでサポートされています 1903 以降。 |
TraceLbrEventListInfo値: 21 ETW が Last Branch Record をトレースするようにトリガーするイベントの一覧を構成します によって構成された TraceLbrConfigurationInfo情報。この値は、Windows 10 バージョン 19H1、Windows Server、バージョンでサポートされています 1903 以降。 |
TraceMaxPmcCounterQuery値: 22 同時に実行できるプロファイリング ソースの最大数を照会します ETW で使用するように構成されています。 この値は、Windows 10 バージョン 19H1、Windows Server、バージョンでサポートされています 1903 以降。 |
TraceStreamCount値: 23 セッションの構成済みストリーム数を照会します。 これは通常ですが、そうではありません 常に、システム上のプロセッサの数に等しいか、または存在しない場合は 1 プロセッサごとのバッファリングは、セッション用に構成されます。 この値は、Windows 10 バージョン 21H2、Windows Server 2022、および 後で行うことはできます。 |
TraceStackCachingInfo値: 24 RegisterTraceGuids ベースのスタック トレースのキャッシュを開始するように ETW に指示します このセッションの ("クラシック") イベント。 この値は、Windows 10 バージョン 21H2、Windows Server 2022、および 後で行うことはできます。 |
TracePmcCounterOwners値: 25 現在のプロセッサ パフォーマンス監視カウンターの一覧を ETW に照会します 使用。 この一覧には、ETW 以外の施設で使用されているカウンターが含まれている場合があります。 この値は、Windows 10 バージョン 21H2、Windows Server 2022、および 後で行うことはできます。 |
TraceUnifiedStackCachingInfo値: 26 両方の RegisterTraceGuids ベースのスタック トレースのキャッシュを開始するように ETW に指示します ("Classic") および EventRegister ベースのイベント。 この値は、Windows 10 バージョン 21H2、Windows Server 2022、および 後で行うことはできます。 |
TracePmcSessionInformation値: 27 と を使用して、PMC 構成セットのすべてのセッションに対してクエリを TracePmcEventListInfoTracePmcCounterListInfo実行します。この値は、Windows 10 バージョン 22H2 以降でサポートされています。 |
TraceContextRegisterInfo値: 28 コンテキストが登録されているシステム イベントの一覧を使用してセッションを構成します イベントが収集されます。 コンテキスト レジスタ イベントに CPU レジスタが含まれている 指定された関連イベントが発生した時点のコンテンツ。 この値は、Windows Server 23H2 以降でサポートされています。 |
MaxTraceSetInfoClass値: 29 列挙体の最後の値をマークします。 使用しないでください。 |
注釈
TRACE_INFO_CLASS列挙体とTRACE_QUERY_INFO_CLASS列挙体はどちらも同じ値を定義します。 EnumerateTraceGuidsEx 関数または TraceSetInformation 関数で両方の列挙体を使用します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 7 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 R2 [デスクトップ アプリのみ] |
| Header | evntrace.h |