Метод IDebugControl2::GetStackTrace (dbgeng.h)

Статья
02/06/2025

Метод getStackTrace возвращает кадры в верхней части указанного стека вызовов.

Синтаксис

HRESULT GetStackTrace(
  [in]            ULONG64            FrameOffset,
  [in]            ULONG64            StackOffset,
  [in]            ULONG64            InstructionOffset,
  [out, writes]   PDEBUG_STACK_FRAME Frames,
  [in]            ULONG              FramesSize,
  [out, optional] PULONG             FramesFilled
);

Параметры

[in] FrameOffset

Указывает расположение кадра стека в верхней части стека. Если FrameOffset равно нулю, используется текущий указатель кадра.

[in] StackOffset

Указывает расположение текущего стека. Если StackOffset равно нулю, используется текущий указатель стека.

[in] InstructionOffset

Указывает расположение инструкции, интересующей функцию, представленную кадром стека в верхней части стека. Если ИнструкцияOffset имеет значение нулю, используется текущая инструкция.

[out, writes] Frames

Получает кадры стека. Количество элементов, которые содержит этот массив, составляет FrameSize.

[in] FramesSize

Указывает количество элементов в массиве кадров.

[out, optional] FramesFilled

Получает количество кадров, помещенных в массив кадров. Если FramesFilledNULL, эти сведения не возвращаются.

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

Этот метод также может возвращать другие значения ошибок. Дополнительные сведения см. в возвращаемых значений.

Возвращаемый код	Описание
S_OK	Метод был успешным.
E_FAIL	Кадры стека не были возвращены.

Замечания

Трассировка стека, возвращенная кадров, можно распечатать с помощью OutputStackTrace.

Требования

Требование	Ценность
целевая платформа	Настольный
заголовка	dbgeng.h (include Dbgeng.h)

См. также

GetContextStackTrace

GetFrameOffset2

GetInstructionOffset2

k, kb, kc, kd, kp, kP, kv (Display Stack Backtrace)

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