PWINDBG_STACKTRACE_ROUTINE Rückruffunktion (wdbgexts.h)

Artikel
03/01/2024

Die funktion PWINDBG_STACKTRACE_ROUTINE (StackTrace) ruft eine Stapelüberwachung für den zu debuggenden Prozess ab. Gibt die Anzahl der Frames zurück, die von StackFrames in den Puffer gelesen werden, auf die von StackFrames verwiesen wird.

Syntax

PWINDBG_STACKTRACE_ROUTINE PwindbgStacktraceRoutine;

ULONG PwindbgStacktraceRoutine(
  [in]  ULONG FramePointer,
  [in]  ULONG StackPointer,
  [in]  ULONG ProgramCounter,
  [out] PEXTSTACKTRACE StackFrames,
  [in]  ULONG Frames
)
{...}

Parameter

[in] FramePointer

Gibt den Framezeiger an. Wenn kein bestimmter Wert gewünscht wird, sollte dieser einfach auf 0 (null) festgelegt werden.

[in] StackPointer

Gibt den Stapelzeiger an. Wenn kein bestimmter Wert gewünscht wird, sollte dieser einfach auf 0 (null) festgelegt werden.

[in] ProgramCounter

Gibt den Anweisungszeiger an. Wenn kein bestimmter Wert gewünscht wird, sollte dieser einfach auf 0 (null) festgelegt werden.

[out] StackFrames

Empfängt die Stapelinformationen. StackFrames muss ein Zeiger auf einen Puffer sein, der groß genug ist, um die anzahl der von Frames angegebenen Stapelframes aufzunehmen. Die Stapelframes werden in der folgenden Datenstruktur gespeichert:

typedef struct _tagEXTSTACKTRACE {
    ULONG       FramePointer;
    ULONG       ProgramCounter;
    ULONG       ReturnAddress;
    ULONG       Args[4];
} EXTSTACKTRACE, *PEXTSTACKTRACE;

[in] Frames

Gibt die maximale Anzahl von Frames an, die in den Puffer passen.

Rückgabewert

Die tatsächliche Anzahl von Frames, die von StackFrames in den Puffer geschrieben werden, auf den gezeigt wird.

Hinweise

Fügen Sie für eine WdbgExts-Erweiterung Wdbgexts.h ein. Für

Eine DbgEng-Erweiterung, schließen Sie Wdbgexts.h vor ein.

Dbgeng.h. Siehe Schreiben von DbgEng-Erweiterungscode für

um Details zu erfahren.

Anforderungen

Anforderung	Wert
Zielplattform	Desktop
Kopfzeile	wdbgexts.h (include Wdbgexts.h, Dbgeng.h)

Freigeben über