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 |
|---|---|
|
O método foi bem-sucedido. |
|
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) |