PWINDBG_STACKTRACE_ROUTINE fonction de rappel (wdbgexts.h)

Article
02/07/2025

La fonction PWINDBG_STACKTRACE_ROUTINE (StackTrace) récupère une trace de pile pour le processus en cours de débogage. Renvoie le nombre de trames lues dans la mémoire tampon pointée par StackFrames.

Syntaxe

PWINDBG_STACKTRACE_ROUTINE PwindbgStacktraceRoutine;

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

Paramètres

[in] FramePointer

Spécifie le pointeur d’image. Si aucune valeur spécifique n’est souhaitée, cela doit simplement être défini sur zéro.

[in] StackPointer

Spécifie le pointeur de pile. Si aucune valeur spécifique n’est souhaitée, cela doit simplement être défini sur zéro.

[in] ProgramCounter

Spécifie le pointeur d’instruction. Si aucune valeur spécifique n’est souhaitée, cela doit simplement être défini sur zéro.

[out] StackFrames

Reçoit les informations de pile. StackFrames doit être un pointeur vers une mémoire tampon suffisamment grande pour contenir le nombre d’images de pile spécifiées par Frames. Les trames de pile sont stockées dans la structure de données suivante :

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

[in] Frames

Spécifie le nombre maximal d’images qui s’adapteront à la mémoire tampon.

Valeur de retour

Nombre réel d’images écrites dans la mémoire tampon pointée par StackFrames.

Remarques

Pour une extension WdbgExts, incluez Wdbgexts.h. Pour

une extension DbgEng, incluez Wdbgexts.h avant

Dbgeng.h. Consultez écriture de code d’extension DbgEng pour

Détails.

Exigences

Exigence	Valeur
plateforme cible	Bureau
d’en-tête	wdbgexts.h (include Wdbgexts.h, Dbgeng.h)

Partager via