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


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

Метод 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

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

[out, writes] Frames

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

[in] FramesSize

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

[out, optional] FramesFilled

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

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

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

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

Комментарии

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

Требования

Требование Значение
Целевая платформа Персональный компьютер
Верхняя часть dbgeng.h (включая Dbgeng.h)

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

GetContextStackTrace

GetFrameOffset2

GetInstructionOffset2

GetStackOffset2

IDebugControl

IDebugControl2

IDebugControl3

OutputStackTrace

StackTrace

k, kb, kc, kd, kp, kP, kv (обратная трассировка стека отображения)