Método IDebugControl3::OutputStackTrace (dbgeng.h)
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 marcos 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. marcas puede ser cualquier combinación de valores de la tabla siguiente.
| Bandera | Descripción |
|---|---|
| DEBUG_STACK_ARGUMENTS | Muestra los tres primeros fragmentos 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 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 números de marco. |
| DEBUG_STACK_PARAMETERS | Muestra los nombres y valores de los parámetros tal y como 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 marcos. |
| 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 información.
| Código devuelto | Descripción |
|---|---|
|
El método se realizó correctamente. |
Observaciones
La matriz de marcos de pila se puede obtener mediante GetStackTrace.
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Escritorio |
| encabezado de | dbgeng.h (include Dbgeng.h) |