Compartilhar via

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

  • Artigo

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 de 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 estiver 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 Frames .

[out, optional] FramesFilled

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

Retornar valor

Esse método também pode retornar outros valores de erro. Consulte 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.

Comentários

O rastreamento de pilha retornado para Frames pode ser impresso usando OutputStackTraceEx.

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho dbgeng.h (inclua Dbgeng.h)

Confira também

GetContextStackTraceEx

GetFrameOffset2

GetInstructionOffset2

GetStackOffset2

IDebugControl5

OutputStackTraceEx

StackTrace

k, kb, kc, kd, kp, kP, kv (Exibir backtrace de pilha)