TraceSetInformation

イベントトレースセッションの設定を構成する。

TraceSetInformation SessionHandle, InformationClass, TraceInformation, InformationLength

SessionHandle : [int] 構成するイベントトレースセッションのハンドル。新しいトレースが開始されたとき、[StartTrace](/windows/win32/api/evntrace/nf-evntrace-starttracea) 関数はこのハンドルを返す。既存のトレースのハンドルを取得するには、[ControlTrace](/windows/win32/api/evntrace/nf-evntrace-controltracew) を使用してトレースの名前に基づいてトレースプロパティを問い合わせ、返された `EVENT_TRACE_PROPERTIES` データの **Wnode.HistoricalContext** フィールドからハンドルを取得する。
InformationClass : [int] 有効または無効にする情報クラス。クラスがキャプチャする情報は、イベントの拡張データセクションに含まれる。有効にできる情報クラスの一覧については、[TRACE_QUERY_INFO_CLASS](/windows/win32/api/evntrace/ne-evntrace-trace_query_info_class) 列挙を参照のこと。
TraceInformation : [intptr] 情報クラス固有のデータへのポインタ。情報クラスによってこのパラメータの内容が決まる。
InformationLength : [int] _TraceInformation_ バッファ内のデータのサイズ（バイト単位）。

(プラグイン / モジュール : advapi32.dll)

解説

イベントトレースセッションの設定を構成する。

[戻り値]
関数が成功した場合、戻り値は ERROR_SUCCESS となる。関数が失敗した場合、戻り値は次のエラーコードのいずれかとなる。-
**ERROR_BAD_LENGTH** プログラムがコマンドを発行したが、コマンド長が不正。このエラーは
_InformationLength_ パラメータが最小サイズ未満の場合に返される。-
**ERROR_INVALID_PARAMETER** パラメータが不正。- **ERROR_NOT_SUPPORTED**
要求はサポートされていない。- **そのほか** 返されたエラーのメッセージ文字列を取得するには
[FormatMessage](/windows/desktop/api/winbase/nf-winbase-formatmessage)
を使用する。

[備考]
[StartTrace](/windows/desktop/ETW/starttrace)
を呼び出した後にこの関数を呼び出す。_InformationClass_ パラメータが **TraceStackTracingInfo**
に設定されている場合、この関数を呼び出すことで指定したカーネルイベントのスタックトレースが有効になる。この関数を後続の呼び出しで呼び出すと、スタックトレースが有効になっていたカーネルイベントの以前のリストが上書きされる。スタックトレースを無効にするには、_InformationClass_
を **TraceStackTracingInfo** に、_InformationLength_ を 0
に設定してこの関数を呼び出す。イベントの拡張データセクションにはコールスタックが含まれる。[StackWalk_Event](/windows/desktop/ETW/stackwalk-event)
MOF クラスが拡張データのレイアウトを定義する。通常、64
ビットコンピュータでは、ページフォールトが許可されていない特定のコンテキストでカーネルスタックをキャプチャすることはできない。x64
でカーネルスタックのウォークを有効にするには、`DisablePagingExecutive` メモリ管理レジストリ値を 1
に設定する。`DisablePagingExecutive` レジストリ値は、次のレジストリキーの下にある:
`HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Session
Manager\Memory Management`。これはシステムのメモリ使用量を増加させるため、一時的な診断目的でのみ行うべきである。

情報