Compartilhar via


Método IDebugControl5::GetStackTraceEx (dbgeng.h)

O método GetStackTraceEx retorna os quadros na parte superior da pilha de chamadas especificada. O método GetStackTraceEx fornece suporte a quadro embutido. Para obter mais informações sobre como trabalhar com funções embutidas, consulte Depurando código otimizado e funções embutidas.

Sintaxe

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
);

Parâmetros

[in] FrameOffset

Especifica o local do quadro de pilha na parte superior da pilha. Se FrameOffset for definido como zero, o ponteiro do quadro atual será usado.

[in] StackOffset

Especifica o local da pilha atual. Se StackOffset for definido como zero, o ponteiro de pilha atual será usado.

[in] InstructionOffset

Especifica o local da instrução de interesse para a função representada pelo quadro de pilha na parte superior da pilha. Se InstructionOffset for definido como zero, a instrução atual será usada.

[out, writes] Frames

Recebe os quadros de pilha. O número de elementos que essa matriz contém é FrameSize.

[in] FramesSize

Especifica o número de itens na matriz quadros.

[out, optional] FramesFilled

Recebe o número de quadros que foram colocados na matriz Quadros. Se quadros preenchidos estiver NULL, essas informações não serão retornadas.

Valor de retorno

Esse método também pode retornar outros valores de erro. Consulte de Valores Retornados para obter mais detalhes.

Código de retorno Descrição
S_OK
O método foi bem-sucedido.
E_FAIL
Nenhum quadro de pilha foi retornado.

Observações

O rastreamento de pilha retornado aos Quadros pode ser impresso usando OutputStackTraceEx.

Requisitos

Requisito Valor
da Plataforma de Destino Desktop
cabeçalho dbgeng.h (inclua Dbgeng.h)

Consulte também

GetContextStackTraceEx

GetFrameOffset2

GetInstructionOffset2

GetStackOffset2

IDebugControl5

OutputStackTrace Ex

StackTrace

k, kb, kc, kd, kp, kP, kv (Display Stack Backtrace)