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， 可选]

可用于组织哈希表的值。 如果此参数为 NULL，则不计算哈希值。

此值是根据 BackTrace 数组中返回的指针的值计算的。 两个相同的堆栈跟踪将生成相同的哈希值。

返回

捕获的帧数。

备注

CaptureStackBackTrace 函数定义为 RtlCaptureStackBackTrace 函数， (定义包含在从 Windows Vista) 开始的 Windows SDK 中。 有关详细信息，请参阅 WinBase.h 和 WinNT.h。

另请参阅