CaptureStackBackTrace 関数

説明

スタックをウォークアップし、各フレームの情報を記録することで、スタック バック トレースをキャプチャします。

USHORT WINAPI CaptureStackBackTrace(
  _In_      ULONG  FramesToSkip,
  _In_      ULONG  FramesToCapture,
  _Out_     PVOID  *BackTrace,
  _Out_opt_ PULONG BackTraceHash
);

パラメーター

FramesToSkip [in]

バック トレースの先頭からスキップするフレームの数。

FramesToCapture [in]

キャプチャするフレームの数。 MAXUSHORT フレームまでキャプチャできます。

Windows Server 2003 および Windows XP:FramesToSkip パラメーターと FramesToCapture パラメーターの合計は 63 未満である必要があります。

BackTrace [out]

現在のスタック トレースからキャプチャされたポインターの配列。

BackTraceHash [out, optional]

ハッシュ テーブルを整理するために使用できる値。 このパラメーターが NULL の場合、ハッシュ値は計算されません。

この値は、BackTrace 配列で返されるポインターの値に基づいて計算されます。 2 つの同じスタック トレースで同じハッシュ値が生成されます。

戻り値

キャプチャされたフレームの数。

解説

CaptureStackBackTrace 関数は RtlCaptureStackBackTrace 関数として定義されます (定義は Windows Vista 以降の Windows SDK に含まれています)。 詳細については、「WinBase.h」と「WinNT.h」を参照してください。

関連項目