IDebugControl4::OutputContextStackTrace メソッド (dbgeng.h)

[アーティクル]
08/07/2023

OutputContextStackTrace メソッドは、スタックフレームと対応するレジスタコンテキストの配列で指定された呼び出し履歴を出力します。

構文

HRESULT OutputContextStackTrace(
  [in] ULONG              OutputControl,
  [in] PDEBUG_STACK_FRAME Frames,
  [in] ULONG              FramesSize,
  [in] PVOID              FrameContexts,
  [in] ULONG              FrameContextsSize,
  [in] ULONG              FrameContextsEntrySize,
  [in] ULONG              Flags
);

パラメーター

[in] OutputControl

出力を送信する場所を指定します。使用可能な値については、「 DEBUG_OUTCTL_XXX」を参照してください。

[in] Frames

出力するスタックフレームの配列を指定します。この配列内の要素の数は FramesSize です。 Frames が NULL の場合、現在のスタックフレームが使用されます。

[in] FramesSize

出力するフレーム数を指定します。

[in] FrameContexts

スタック内の各フレームのレジスタコンテキストを指定します。この配列のエントリは 、Frames 配列のエントリに対応します。スレッドコンテキストの型は、ターゲットの有効なプロセッサの CONTEXT 構造体です。

[in] FrameContextsSize

FrameContexts が指すメモリのサイズをバイト単位で指定します。スタックフレームの数はコンテキストの数と等しく、FrameContextsSize は FrameContextsEntrySize を乗算した FramesSize である必要があります。

[in] FrameContextsEntrySize

FrameContexts の各フレームコンテキストのサイズをバイト単位で指定します。

[in] Flags

フレームごとに出力する情報を決定するビットフラグを指定します。 フラグ は、次の表の値の任意の組み合わせにすることができます。

フラグ	説明
DEBUG_STACK_ARGUMENTS	各呼び出しのフレームに、スタックメモリの最初の 3 つの部分を表示します。スタックに引数が渡され、フレームのコードでスタック引数が使用されるプラットフォームでは、これらの値は関数の引数になります。
DEBUG_STACK_FUNCTION_INFO	フレームに対応する関数に関する情報を表示します。これには、呼び出し規則とフレームポインター省略 (FPO) 情報が含まれます。
DEBUG_STACK_SOURCE_LINE	スタックトレースの各フレームのソース行情報を表示します。
DEBUG_STACK_FRAME_ADDRESSES	各フレームのリターンアドレス、前のフレームアドレス、およびその他の関連するアドレスを表示します。
DEBUG_STACK_COLUMN_NAMES	列名を表示します。
DEBUG_STACK_NONVOLATILE_REGISTERS	各フレームの非揮発性レジスタコンテキストを表示します。これは、一部のプラットフォームでのみ意味があります。
DEBUG_STACK_FRAME_NUMBERS	フレーム番号を表示します。
DEBUG_STACK_PARAMETERS	シンボル情報で指定されたパラメーター名と値を表示します。
DEBUG_STACK_FRAME_ADDRESSES_RA_ONLY	スタックフレームアドレスのリターンアドレスのみを表示します。
DEBUG_STACK_FRAME_MEMORY_USAGE	フレームを区切るバイト数を表示します。
DEBUG_STACK_PARAMETERS_NEWLINE	各パラメーターとその型と値を新しい行に表示します。