ENABLE_TRACE_PARAMETERS_V1構造体 (evntrace.h)
ENABLE_TRACE_PARAMETERS_V1構造体には、EnableTraceEx2 を介してプロバイダーを有効にするために使用される情報が含まれています。 この構造は廃止されました。 代わりに ENABLE_TRACE_PARAMETERS を使用してください。
構文
typedef struct _ENABLE_TRACE_PARAMETERS_V1 {
ULONG Version;
ULONG EnableProperty;
ULONG ControlFlags;
GUID SourceId;
PEVENT_FILTER_DESCRIPTOR EnableFilterDesc;
} ENABLE_TRACE_PARAMETERS_V1, *PENABLE_TRACE_PARAMETERS_V1;
メンバー
Version
ENABLE_TRACE_PARAMETERS_VERSION (1) に設定します。
EnableProperty
イベントの作成時に ETW に含めることができるオプションの情報。 データは、イベントの 拡張データ項目 セクションに書き込まれます。 オプションの情報を含めるには、次のフラグの 1 つ以上を指定します。それ以外の場合は、0 に設定します。
EVENT_ENABLE_PROPERTY_SID
ユーザーのセキュリティ識別子 (SID) を拡張データに含めます。
EVENT_ENABLE_PROPERTY_TS_ID
ターミナル セッション識別子を拡張データに含めます。
EVENT_ENABLE_PROPERTY_STACK_TRACE
EventWrite を使用して書き込まれたイベントの拡張データに呼び出し履歴トレースを追加します。
注意
ETW は、イベントの合計サイズが 64,000 を超えると、イベントを削除します。 プロバイダーが最大 64K に近いサイズのイベントをログに記録している場合は、スタック キャプチャを有効にするとイベントが失われる可能性があります。
スタックがフレームの最大数 (192) より長い場合、フレームはスタックの下部から切り取られます。
コンシューマーの場合、イベントには 、EVENT_EXTENDED_ITEM_STACK_TRACE32または拡張 アイテム EVENT_EXTENDED_ITEM_STACK_TRACE64 含まれます。 32 ビット コンシューマーは、64 ビット プロセスから 64 ビット スタック トレースを受信する場合があることに注意してください。
ControlFlags
予約済み。 0 に設定されます。
SourceId
プロバイダーを有効または無効にする呼び出し元を一意に識別する GUID。 プロバイダーが EnableCallback を実装していない場合、GUID は使用されません。
EnableFilterDesc
フィルター データを指す EVENT_FILTER_DESCRIPTOR 構造体。 プロバイダーはフィルター データを使用して、フィルター条件に一致するイベントがセッションに書き込まれないようにします。 プロバイダーは、データのレイアウトと、フィルターをイベントのデータに適用する方法を決定します。 セッションでプロバイダーに渡すことができるフィルターは 1 つだけです。
セッションは TdhEnumerateProviderFilters 関数を呼び出して、プロバイダーに渡すことができるスキーマ化されたフィルターを決定できます。
解説
ENABLE_TRACE_PARAMETERS_V1 は廃止されました。 ENABLE_TRACE_PARAMETERS構造体はバージョン 2 の構造体であり、ENABLE_TRACE_PARAMETERS_V1構造体を置き換えます。
通常、64 ビット コンピューターでは、ページ フォールトが許可されていない場合、特定のコンテキストでカーネル スタックをキャプチャすることはできません。 x64 でカーネル スタックのウォークを有効にするには、メモリ管理レジストリ値を DisablePagingExecutive 1 に設定します。 レジストリ値はDisablePagingExecutive、次のレジストリ キーの下にあります。 HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Session Manager\Memory Management
これは、システムのメモリ使用量が増加するため、一時的な診断目的でのみ行う必要があります。
要件
| サポートされている最小のクライアント | Windows 7 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 R2 [デスクトップ アプリのみ] |
| Header | evntrace.h |