Поделиться через

Функция RtlCaptureStackBackTrace (winnt.h)

  • Статья

Подпрограмма RtlCaptureStackBackTrace захватывает трассировку стека назад, проходя вверх по стеку и записывая сведения для каждого кадра.

Синтаксис

NTSYSAPI WORD RtlCaptureStackBackTrace(
  [in]            DWORD  FramesToSkip,
  [in]            DWORD  FramesToCapture,
  [out]           PVOID  *BackTrace,
  [out, optional] PDWORD BackTraceHash
);

Параметры

[in] FramesToSkip

Количество кадров, пропускаемых с начала обратной трассировки.

[in] FramesToCapture

Количество кадров, которые необходимо записать.

[out] BackTrace

Массив указателей, захваченных из текущей трассировки стека.

[out, optional] BackTraceHash

Необязательное значение, которое можно использовать для упорядочения хэш-таблиц. Если этот параметр имеет значение NULL, хэш-значение не вычисляется.

Это значение вычисляется на основе значений указателей, возвращаемых в массиве BackTrace . Две одинаковые трассировки стека создают одинаковые хэш-значения.

Возвращаемое значение

Количество захваченных кадров.

Требования

   
Минимальная версия клиента Доступно в начиная с Windows XP.
Целевая платформа Универсальное
Верхняя часть winnt.h (включая Ntifs.h, FltKernel.h)
Библиотека NtosKrnl.lib; OneCoreUAP.lib в Windows 10
DLL NtDll.dll (пользовательский режим); NtosKrnl.exe (режим ядра)
IRQL <= DISPATCH_LEVEL