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

El método GetStackTrace devuelve los marcos situados en 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 está establecido en cero, se usa el puntero de marco actual en su lugar.

[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 InstructionOffset está establecido 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 Frames .

[out, optional] FramesFilled

Recibe el número de fotogramas que se colocaron en los marcos de matriz. Si FramesFilled es NULL, esta información no se devuelve.

Valor devuelto

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

Código devuelto	Descripción
S_OK	Método realizado correctamente.
E_FAIL	No se devolvieron marcos de pila.

Comentarios

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

Requisitos

Requisito	Value
Plataforma de destino	Escritorio
Encabezado	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)