IDebugControl5::GetStackTraceEx-Methode (dbgeng.h)

Artikel
02/26/2024

Die GetStackTraceEx-Methode gibt die Frames am oberen Rand des angegebenen Aufrufstapels zurück. Die GetStackTraceEx-Methode bietet Inlineframeunterstützung. Weitere Informationen zum Arbeiten mit Inlinefunktionen finden Sie unter Debuggen von optimiertem Code und Inlinefunktionen.

Syntax

HRESULT GetStackTraceEx(
  [in]            ULONG64               FrameOffset,
  [in]            ULONG64               StackOffset,
  [in]            ULONG64               InstructionOffset,
  [out, writes]   PDEBUG_STACK_FRAME_EX 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.