IDebugControl2::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 です。 フレーム が NULL 場合、現在のスタック フレームが使用されます。
[in] FramesSize
出力するフレームの数を指定します。
[in] Flags
各フレームに対して出力する情報を決定するビット フラグを指定します。 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を使用して取得できます。
必要条件
| 要件 | 価値 |
|---|---|
| ターゲット プラットフォーム の | デスクトップ |
| ヘッダー | dbgeng.h (Dbgeng.h を含む) |
関連項目
GetContextStackTrace の
IDebugControl の
IDebugControl2 の
IDebugControl3 の