PWINDBG_STACKTRACE_ROUTINE função de retorno de chamada (wdbgexts.h)

Artigo
02/07/2025

A função PWINDBG_STACKTRACE_ROUTINE (StackTrace) recupera um rastreamento de pilha para o processo que está sendo depurado. Retorna o número de quadros lidos no buffer apontado por StackFrames.

Sintaxe

PWINDBG_STACKTRACE_ROUTINE PwindbgStacktraceRoutine;

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

Parâmetros

[in] FramePointer

Especifica o ponteiro de quadro. Se nenhum valor específico for desejado, isso deverá ser simplesmente definido como zero.

[in] StackPointer

Especifica o ponteiro de pilha. Se nenhum valor específico for desejado, isso deverá ser simplesmente definido como zero.

[in] ProgramCounter

Especifica o ponteiro de instrução. Se nenhum valor específico for desejado, isso deverá ser simplesmente definido como zero.

[out] StackFrames

Recebe as informações da pilha. StackFrames deve ser um ponteiro para um buffer grande o suficiente para manter o número de quadros de pilha especificados por Frames. Os quadros de pilha são armazenados na seguinte estrutura de dados:

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

[in] Frames

Especifica o número máximo de quadros que se ajustarão ao buffer.

Valor de retorno

O número real de quadros gravados no buffer apontado por StackFrames.

Observações

Para uma extensão WdbgExts, inclua Wdbgexts.h. Durante

uma extensão DbgEng, inclua Wdbgexts.h antes

Dbgeng.h. Consulte gravando de código de extensão DbgEng para

Detalhes.

Requisitos

Requisito	Valor
da Plataforma de Destino	Área de trabalho
cabeçalho	wdbgexts.h (inclua Wdbgexts.h, Dbgeng.h)

Compartilhar via