Метод IDebugControl::OutputStackTrace (dbgeng.h)

Статья
02/06/2025

Метод OutputStackTrace выводит предоставленный кадр стека или текущие кадры стека.

Синтаксис

HRESULT OutputStackTrace(
  [in]           ULONG              OutputControl,
  [in, optional] PDEBUG_STACK_FRAME Frames,
  [in]           ULONG              FramesSize,
  [in]           ULONG              Flags
);

Параметры

[in] OutputControl

Указывает место отправки выходных данных. Возможные значения см. в разделе DEBUG_OUTCTL_XXX.

[in, optional] Frames

Задает массив кадров стека для вывода. Количество элементов в этом массиве — FramesSize. Если кадрыNULL, используются текущие кадры стека.

[in] FramesSize

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

[in] Flags

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

Флаг	Описание
DEBUG_STACK_ARGUMENTS	Отображает первые три части памяти стека в кадре каждого вызова. На платформах, где параметры передаются в стеке, и код для кадра использует аргументы стека, эти значения будут аргументами функции.
DEBUG_STACK_FUNCTION_INFO	Отображает сведения о функции, соответствующей кадру. Это включает в себя сведения о соглашении о вызовах и пропуске указателя кадров (FPO).
DEBUG_STACK_SOURCE_LINE	Отображает сведения о строке источника для каждого кадра трассировки стека.
DEBUG_STACK_FRAME_ADDRESSES	Отображает возвращаемый адрес, предыдущий адрес кадра и другие соответствующие адреса для каждого кадра.
DEBUG_STACK_COLUMN_NAMES	Отображает имена столбцов.
DEBUG_STACK_NONVOLATILE_REGISTERS	Отображает ненезависимый контекст регистра для каждого кадра. Это важно только для некоторых платформ.
DEBUG_STACK_FRAME_NUMBERS	Отображает номера кадров.
DEBUG_STACK_PARAMETERS	Отображает имена параметров и значения, указанные в сведениях о символах.
DEBUG_STACK_FRAME_ADDRESSES_RA_ONLY	Отображает только возвращаемый адрес в адресах кадров стека.
DEBUG_STACK_FRAME_MEMORY_USAGE	Отображает количество байтов, разделяющих кадры.
DEBUG_STACK_PARAMETERS_NEWLINE	Отображает каждый параметр и его тип и значение в новой строке.