IDebugControl2::GetStackTrace-Methode (dbgeng.h)

Artikel
02/23/2024

Die GetStackTrace-Methode gibt die Frames am oberen Rand des angegebenen Aufrufstapels 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 am oberen Rand des Stapels 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 den Speicherort der interessanten Anweisung für die Funktion an, die durch den Stapelrahmen am oberen Rand des Stapels dargestellt wird. Wenn InstructionOffset auf 0 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.