PWINDBG_STACKTRACE_ROUTINE fonction de rappel (wdbgexts.h)

La fonction PWINDBG_STACKTRACE_ROUTINE (StackTrace) récupère une trace de pile pour le processus en cours de débogage. Retourne le nombre d’images 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, cette valeur doit simplement être définie sur zéro.

[in] StackPointer

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

[in] ProgramCounter

Spécifie le pointeur d’instruction. Si aucune valeur spécifique n’est souhaitée, cette valeur doit simplement être définie 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 doivent tenir dans la mémoire tampon.

Valeur retournée

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

Remarques

Pour une extension WdbgExts, incluez Wdbgexts.h. For

une extension DbgEng, inclure Wdbgexts.h avant

Dbgeng.h. Consultez Écriture du code d’extension DbgEng pour

Détails.

Configuration requise