Compartir a través de


Método IDebugControl3::GetStackTrace (dbgeng.h)

El método GetStackTrace devuelve los fotogramas de la parte superior de la pila de llamadas especificada.

Sintaxis

HRESULT GetStackTrace(
  [in]            ULONG64            FrameOffset,
  [in]            ULONG64            StackOffset,
  [in]            ULONG64            InstructionOffset,
  [out, writes]   PDEBUG_STACK_FRAME Frames,
  [in]            ULONG              FramesSize,
  [out, optional] PULONG             FramesFilled
);

Parámetros

[in] FrameOffset

Especifica la ubicación del marco de pila en la parte superior de la pila. Si frameOffset se establece en cero, se usa en su lugar el puntero de marco actual.

[in] StackOffset

Especifica la ubicación de la pila actual. Si StackOffset se establece en cero, se usa el puntero de pila actual en su lugar.

[in] InstructionOffset

Especifica la ubicación de la instrucción de interés para la función representada por el marco de pila en la parte superior de la pila. Si instrucciónOffset se establece en cero, se usa la instrucción actual en su lugar.

[out, writes] Frames

Recibe los marcos de pila. El número de elementos que contiene esta matriz es FrameSize.

[in] FramesSize

Especifica el número de elementos de la matriz de Marcos.

[out, optional] FramesFilled

Recibe el número de fotogramas que se colocaron en la matriz Frames. Si framesFilled es NULL, no se devuelve esta información.

Valor devuelto

Este método también puede devolver otros valores de error. Consulte valores devueltos para obtener más información.

Código devuelto Descripción
S_OK
El método se realizó correctamente.
E_FAIL
No se devolvieron marcos de pila.

Observaciones

El seguimiento de pila devuelto a frames se puede imprimir mediante OutputStackTrace.

Requisitos

Requisito Valor
de la plataforma de destino de Escritorio
encabezado de dbgeng.h (include Dbgeng.h)

Consulte también

GetContextStackTrace

GetFrameOffset2

GetInstructionOffset2

GetStackOffset2

IDebugControl

IDebugControl2

IDebugControl3

outputStackTrace

stackTrace

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