IDebugControl::OutputStackTrace メソッド (dbgeng.h)
OutputStackTrace メソッドは、指定されたスタック フレームまたは現在のスタック フレームを出力します。
構文
HRESULT OutputStackTrace(
[in] ULONG OutputControl,
[in, optional] PDEBUG_STACK_FRAME Frames,
[in] ULONG FramesSize,
[in] ULONG Flags
);
パラメーター
[in] OutputControl
出力を送信する場所を指定します。 使用可能な値については、「 DEBUG_OUTCTL_XXX」を参照してください。
[in, optional] Frames
出力するスタック フレームの配列を指定します。 この配列内の要素の数は FramesSize です。 Frames が NULL の場合、現在のスタック フレームが使用されます。
[in] FramesSize
出力するフレームの数を指定します。
[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 | 各パラメーターとその型と値を新しい行に表示します。 |
戻り値
このメソッドは、エラー値を返す場合もあります。 詳細については、「 戻り値 」を参照してください。
リターン コード | 説明 |
---|---|
|
メソッドは正常に実行されました。 |
注釈
スタック フレームの配列は 、GetStackTrace を使用して取得できます。
要件
要件 | 値 |
---|---|
対象プラットフォーム | デスクトップ |
Header | dbgeng.h (Dbgeng.h を含む) |