Compartilhar via


Método IDebugControl3::GetStackTrace (dbgeng.h)

O método GetStackTrace retorna os quadros na parte superior da pilha de chamadas especificada.

Sintaxe

HRESULT GetStackTrace(
  [in]            ULONG64            FrameOffset,
  [in]            ULONG64            StackOffset,
  [in]            ULONG64            InstructionOffset,
  [out, writes]   PDEBUG_STACK_FRAME 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 OutputStackTrace.

Requisitos

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

Confira também

GetContextStackTrace

GetFrameOffset2

GetInstructionOffset2

GetStackOffset2

Idebugcontrol

IDebugControl2

IDebugControl3

OutputStackTrace

StackTrace

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