Функция 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 SDK, начиная с Windows Vista). Дополнительные сведения см. в разделах WinBase.h и WinNT.h.

См. также раздел