TraceSetInformation 関数 (evntrace.h)

TraceSetInformation 関数は、イベント トレース セッションの設定を構成します。

構文

ULONG WMIAPI TraceSetInformation(
       CONTROLTRACE_ID  TraceId,
  [in] TRACE_INFO_CLASS InformationClass,
  [in] PVOID            TraceInformation,
  [in] ULONG            InformationLength
);

パラメーター

TraceId

[in] InformationClass

有効または無効にする情報クラス。 クラスがキャプチャする情報は、イベントの拡張データ セクションに含まれます。 有効にできる情報クラスの一覧については、 TRACE_QUERY_INFO_CLASS 列挙型を参照してください。

[in] TraceInformation

情報クラス固有のデータへのポインター。 情報クラスは、このパラメーターの内容を決定します。

[in] InformationLength

TraceInformation バッファー内のデータのサイズ (バイト単位)。

戻り値

関数が成功した場合、戻り値はERROR_SUCCESS。

関数が失敗した場合、戻り値は次のいずれかのエラー コードになります。

• ERROR_BAD_LENGTH

  プログラムがコマンドを発行しましたが、コマンドの長さが正しくありません。 このエラーは、 InformationLength パラメーターが最小サイズ未満の場合に返されます。

• ERROR_INVALID_PARAMETER

  パラメーターが正しくありません。

• ERROR_NOT_SUPPORTED

  要求はサポートされていません。

• その他

  FormatMessage を使用して、返されたエラーのメッセージ文字列を取得します。

注釈

StartTrace を呼び出した後、この関数を呼び出します。

InformationClass パラメーターが TraceStackTracingInfo に設定されている場合、この関数を呼び出すと、指定したカーネル イベントのスタック トレースが有効になります。 この関数の後続の呼び出しにより、スタック トレースが有効になっているカーネル イベントの前の一覧が上書きされます。 スタック トレースを無効にするには、 InformationClass を TraceStackTracingInfo に設定し、 InformationLength を 0 に設定してこの関数を呼び出します。

イベントの拡張データ セクションには、呼び出し履歴が含まれます。 StackWalk_Event MOF クラスは、拡張データのレイアウトを定義します。

通常、64 ビット コンピューターでは、ページ フォールトが許可されていない場合、特定のコンテキストでカーネル スタックをキャプチャすることはできません。 x64 でカーネル スタックのウォークを有効にするには、 DisablePagingExecutive メモリ管理レジストリの値を 1 に設定します。 DisablePagingExecutiveレジストリ値は、次のレジストリ キーの下にあります: HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Session Manager\Memory Management。 これは、システムのメモリ使用量が増加するため、一時的な診断目的でのみ行う必要があります。

Requirements

こちらも参照ください

TRACE_QUERY_INFO_CLASS

TraceQueryInformation