Método IDebugControl4::OutputContextStackTrace (dbgeng.h)

Artículo
08/07/2023

El método OutputContextStackTrace imprime la pila de llamadas especificada por una matriz de marcos de pila y los contextos de registro correspondientes.

Sintaxis

HRESULT OutputContextStackTrace(
  [in] ULONG              OutputControl,
  [in] PDEBUG_STACK_FRAME Frames,
  [in] ULONG              FramesSize,
  [in] PVOID              FrameContexts,
  [in] ULONG              FrameContextsSize,
  [in] ULONG              FrameContextsEntrySize,
  [in] ULONG              Flags
);

Parámetros

[in] OutputControl

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

[in] 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 usa el marco de pila actual.

[in] FramesSize

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

[in] FrameContexts

Especifica el contexto de registro de cada fotograma de la pila. Las entradas de esta matriz corresponden a las entradas de la matriz Frames . El tipo del contexto del subproceso es la estructura CONTEXT del procesador efectivo del destino.

[in] FrameContextsSize

Especifica el tamaño, en bytes, de la memoria a la que apunta FrameContexts. El número de marcos de pila debe ser igual al número de contextos y FrameContextsSize debe ser igual a FramesSize multiplicado por FrameContextsEntrySize.

[in] FrameContextsEntrySize

Especifica el tamaño, en bytes, de cada contexto de marco en FrameContexts.

[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 argumentos 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.