Leer en inglés

Compartir a través de


Método IDebugControl5::OutputStackTraceEx (dbgeng.h)

El método OutputStackTraceEx genera el marco de pila proporcionado o los marcos de pila actuales. El método OutputStackTraceEx proporciona compatibilidad con fotogramas insertados. Para obtener más información sobre cómo trabajar con funciones insertadas, vea Depuración de código optimizado y funciones insertadas.

Sintaxis

HRESULT OutputStackTraceEx(
  [in]           ULONG                 OutputControl,
  [in, optional] PDEBUG_STACK_FRAME_EX Frames,
  [in]           ULONG                 FramesSize,
  [in]           ULONG                 Flags
);

Parámetros

[in] OutputControl

Especifica dónde enviar la salida. Para obtener 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 las tres primeras partes de memoria de pila en el marco de cada llamada. En las plataformas en las que 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 marco del seguimiento de la pila.
DEBUG_STACK_FRAME_ADDRESSES Muestra la dirección de retorno, la dirección de fotograma 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 de marco de pila.
DEBUG_STACK_FRAME_MEMORY_USAGE Muestra el número de bytes que separan los fotogramas.
DEBUG_STACK_PARAMETERS_NEWLINE Muestra cada parámetro y su tipo y valor en una nueva línea.

Valor devuelto

Este método también puede devolver valores de error. Consulte Valores devueltos para obtener más detalles.

Código devuelto Descripción
S_OK
Método realizado correctamente.

Comentarios

La matriz de marcos de pila se puede obtener mediante GetStackTraceEx.

Requisitos

Requisito Value
Plataforma de destino Escritorio
Encabezado dbgeng.h (include Dbgeng.h)

Consulte también

GetContextStackTraceEx

GetStackTraceEx

IDebugControl5

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