Método IDebugControl::OutputStackTrace (dbgeng.h)

Artículo
08/07/2023

El método OutputStackTrace genera el marco de pila proporcionado o los marcos de pila actuales.

Sintaxis

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

Parámetros

[in] OutputControl

Especifica dónde enviar la salida. Para conocer los valores posibles, consulte DEBUG_OUTCTL_XXX.

[in, optional] Frames

Especifica la matriz de marcos de pila que se van a generar. El número de elementos de esta matriz es FramesSize. Si Frames es NULL, se usan los marcos de pila actuales.

[in] FramesSize

Especifica el número de fotogramas que se van a generar.

[in] Flags

Especifica marcas de bits que determinan qué información se va a generar para cada fotograma. Las marcas pueden ser cualquier combinación de valores de la tabla siguiente.

Marca	Descripción
DEBUG_STACK_ARGUMENTS	Muestra los tres primeros fragmentos de memoria de pila en el marco de cada llamada. En plataformas donde se pasan parámetros en la pila y el código del marco usa argumentos de pila, estos valores serán los argumentos de la función.
DEBUG_STACK_FUNCTION_INFO	Muestra información sobre la función que corresponde al marco. Esto incluye la convención de llamada y la información de omisión del puntero de marco (FPO).
DEBUG_STACK_SOURCE_LINE	Muestra información de línea de origen para cada fotograma del seguimiento de pila.
DEBUG_STACK_FRAME_ADDRESSES	Muestra la dirección de retorno, la dirección de marco anterior y otras direcciones pertinentes para cada fotograma.
DEBUG_STACK_COLUMN_NAMES	Muestra los nombres de columna.
DEBUG_STACK_NONVOLATILE_REGISTERS	Muestra el contexto de registro no volátil para cada fotograma. Esto solo es significativo para algunas plataformas.
DEBUG_STACK_FRAME_NUMBERS	Muestra los números de fotograma.
DEBUG_STACK_PARAMETERS	Muestra los nombres de parámetro y los valores según se indica en la información de símbolos.
DEBUG_STACK_FRAME_ADDRESSES_RA_ONLY	Muestra solo la dirección de retorno en las direcciones del marco de pila.
DEBUG_STACK_FRAME_MEMORY_USAGE	Muestra el número de bytes que separan los marcos.
DEBUG_STACK_PARAMETERS_NEWLINE	Muestra cada parámetro y su tipo y valor en una nueva línea.