次の方法で共有

UpdateHeapTrace

  • [アーティクル]

この関数は、PID、スタックウォーキング イベント、またはその他の ETW セッションの変更の新しいセットを使用して、既存のヒープ トレース セッションを更新します。

ULONG
WINAPI
UpdateHeapTrace(
    _Inout_ PEVENT_TRACE_PROPERTIES Properties,
    _In_z_ LPCWSTR wszSessionName,
    _In_reads_opt_(cPids) const ULONG Pids[],
    _In_  ULONG cPids,
    _In_reads_opt_(cStackTracingEventIds) const STACK_TRACING_EVENT_ID StackTracingEventIds[],
    _In_  ULONG cStackTracingEventIds
    );

パラメーター

TraceHandle [out]
イベント トレース セッションへのハンドルを格納します。 ハンドルが無効な場合、このパラメーターは 0 に設定されます。 このパラメーターは、INVALID_HANDLE_VALUE と比較する事はできません。 関数が失敗した場合は、このハンドルを使用しないでください。

Properties [in, out]
セッションに対して更新されたプロパティを含む EVENT_TRACE_PROPERTIES 構造体へのポインター。 この構造体のどのメンバーを指定できるかについては、Controltrace EVENT_TRACE_CONTROL_UPDATE を使用した ControlTrace 関数に関する説明を参照してください。

wszSessionName[in]
更新するヒープ トレース セッションの名前。 これは、StartHeapTrace に渡された名前と同じである必要があります。

Pids [in]
ヒープ トレースを有効にするプロセス ID の配列。

cPids [in, out]
Pids 配列のサイズ。

StackTracingEventIds [in]
有効にする必要があるヒープイベントのスタック ウォークを指定する STACK_TRACING_EVENT_ID 構造体の配列。 NULL にすることができます。

cStackTracingEventIds [in]
StackTracingEventIds 配列のサイズ。

戻り値

ERROR_SUCCESS は成功を示します。

次の表に、このオプションでエラーの可能性な値を示します。

エラー値 説明

ERROR_ALREADY_EXISTS

システム上で実行されるカーネル ロガーのインスタンスは 1 つのみです。 別のコンポーネントがカーネル ログを開始した後にこの関数を開始しようとすると、このエラーが返される可能性があります。

ERROR_INVALID_FLAGS

Properties.EnableFlagsに無効なトレース フラグが含まれている可能性があります。

ERROR_OUT_OF_MEMORY

EVENT_TRACE_PROPERTIES に対してメモリの割り当てに失敗した可能性があります。

一覧以外の理由で失敗した場合は、システム エラー コードが返されます。

解説

なし

関数

StartHeapTrace