IDebugControl::GetStackTrace-Methode (dbgeng.h)

Artikel
02/06/2025

Die GetStackTrace--Methode gibt die Frames oben im angegebenen Aufrufstapel 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 Null festgelegt ist, wird stattdessen der aktuelle Framezeiger verwendet.

[in] StackOffset

Gibt die Position des aktuellen Stapels an. Wenn StackOffset- auf Null festgelegt ist, wird stattdessen der aktuelle Stapelzeiger verwendet.

[in] InstructionOffset

Gibt die Position der interessanten 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 Stapelframes. 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 im Array Framesplatziert wurden. Wenn FramesFilled-NULL-ist, werden diese Informationen nicht zurückgegeben.