IDebugControl5::GetContextStackTraceEx メソッド (dbgeng.h)

[アーティクル]
02/07/2025

GetContextStackTraceEx メソッドは、呼び出し履歴の先頭にあるフレームを返し、任意のレジスタコンテキストから始まり、各スタックフレームの再構築されたレジスタコンテキストを返します。 GetContextStackTraceEx メソッドは、インラインフレームのサポートを提供します。インライン関数の操作の詳細については、「最適化されたコードとインライン関数のデバッグ」を参照してください。

構文

HRESULT GetContextStackTraceEx(
  [in, optional]  PVOID                 StartContext,
  [in]            ULONG                 StartContextSize,
  [out, optional] PDEBUG_STACK_FRAME_EX Frames,
  [in]            ULONG                 FramesSize,
  [out, optional] PVOID                 FrameContexts,
  [in]            ULONG                 FrameContextsSize,
  [in]            ULONG                 FrameContextsEntrySize,
  [out, optional] PULONG                FramesFilled
);

パラメーター

[in, optional] StartContext

スタックの先頭のレジスタコンテキストを指定します。

[in] StartContextSize

StartContext レジスタコンテキストのサイズをバイト単位で指定します。

[out, optional] Frames

スタックフレームを受け取ります。この配列が保持する要素の数は FrameSize です。 Frames が NULL の場合、この情報は返されません。

[in] FramesSize

配列 Frames 内の項目数を指定 します。

[out, optional] FrameContexts

スタック内のフレームごとに再構築されたレジスタコンテキストを受け取ります。この配列のエントリは 、Frames 配列のエントリに対応します。スレッドコンテキストの型は、ターゲットの有効なプロセッサの CONTEXT 構造体です。 FrameContexts が NULL の場合、この情報は返されません。

[in] FrameContextsSize

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

[in] FrameContextsEntrySize

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

[out, optional] FramesFilled

FrameContexts の配列 Frames とコンテキストに配置されたフレームの数を受け取ります。 FramesFilled が NULL の場合、この情報は返されません。

戻り値

リターンコード	説明
S_OK	メソッドは正常に実行されました。

このメソッドは、エラー値を返すこともできます。詳細については、「戻り値」を参照してください。

注釈

Frames および FrameContexts に返されるスタックトレースは、OutputContextStackTraceEx を使用して出力できます。

スタックアンワインドでは、レジスタのサブセットのみを復元するのが一般的です。たとえば、スタックアンワインドでは、揮発性レジスタはスクラッチレジスタであり、コードで保持する必要がないため、揮発性レジスタの状態が常に復元されるとは限りません。アンワインド時に復元されないレジスタは、復元された最後の値として残されるため、アンワインドによって復元されない可能性があるレジスタ状態を使用する場合は注意が必要です。