Freigeben über


IDebugControl3::GetStackTrace-Methode (dbgeng.h)

Die GetStackTrace-Methode gibt die Frames am Anfang der angegebenen Aufrufliste zurück.

Syntax

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

Parameter

[in] FrameOffset

Gibt die Position des Stapelrahmens oben im Stapel an. Wenn FrameOffset auf 0 festgelegt ist, wird stattdessen der aktuelle Framezeiger verwendet.

[in] StackOffset

Gibt den Speicherort des aktuellen Stapels an. Wenn StackOffset auf 0 festgelegt ist, wird stattdessen der aktuelle Stapelzeiger verwendet.

[in] InstructionOffset

Gibt die Position der relevanten Anweisung für die Funktion an, die durch den Stapelrahmen oben im Stapel dargestellt wird. Wenn InstructionOffset auf null festgelegt ist, wird stattdessen die aktuelle Anweisung verwendet.

[out, writes] Frames

Empfängt die Stapelrahmen. Die Anzahl der Elemente, die dieses Array enthält, ist FrameSize.

[in] FramesSize

Gibt die Anzahl der Elemente im Frames-Array an.

[out, optional] FramesFilled

Empfängt die Anzahl der Frames, die in den Arrayframes platziert wurden. Wenn FramesFilledNULL ist, werden diese Informationen nicht zurückgegeben.

Rückgabewert

Diese Methode gibt möglicherweise auch andere Fehlerwerte zurück. Weitere Informationen finden Sie unter Rückgabewerte .

Rückgabecode BESCHREIBUNG
S_OK
Die Methode war erfolgreich.
E_FAIL
Es wurden keine Stapelframes zurückgegeben.

Hinweise

Die an Frames zurückgegebene Stapelablaufverfolgung kann mit OutputStackTrace gedruckt werden.

Anforderungen

Anforderung Wert
Zielplattform Desktop
Kopfzeile dbgeng.h (dbgeng.h einschließen)

Weitere Informationen

GetContextStackTrace

GetFrameOffset2

GetInstructionOffset2

GetStackOffset2

IDebugControl

IDebugControl2

IDebugControl3

OutputStackTrace

StackTrace

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