Compartilhar via


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

O método OutputStackTrace gera o quadro de pilha fornecido ou os quadros de pilha atuais.

Sintaxe

HRESULT OutputStackTrace(
  [in]           ULONG              OutputControl,
  [in, optional] PDEBUG_STACK_FRAME Frames,
  [in]           ULONG              FramesSize,
  [in]           ULONG              Flags
);

Parâmetros

[in] OutputControl

Especifica para onde enviar a saída. Para obter valores possíveis, consulte DEBUG_OUTCTL_XXX.

[in, optional] Frames

Especifica a matriz de quadros de pilha a serem gerados. O número de elementos nessa matriz é FramesSize. Se Frames for NULL, os quadros de pilha atuais serão usados.

[in] FramesSize

Especifica o número de quadros a serem gerados.

[in] Flags

Especifica sinalizadores de bits que determinam quais informações serão geradas para cada quadro. Os sinalizadores podem ser qualquer combinação de valores da tabela a seguir.

Sinalizador Descrição
DEBUG_STACK_ARGUMENTS Exibe as três primeiras partes da memória de pilha no quadro de cada chamada. Em plataformas em que os parâmetros são passados na pilha e o código para o quadro usa argumentos de pilha, esses valores serão os argumentos para a função.
DEBUG_STACK_FUNCTION_INFO Exibe informações sobre a função que corresponde ao quadro. Isso inclui informações de convenção de chamada e FPO (omissão de ponteiro de quadro).
DEBUG_STACK_SOURCE_LINE Exibe informações de linha de origem para cada quadro do rastreamento de pilha.
DEBUG_STACK_FRAME_ADDRESSES Exibe o endereço de retorno, o endereço do quadro anterior e outros endereços relevantes para cada quadro.
DEBUG_STACK_COLUMN_NAMES Exibe nomes de coluna.
DEBUG_STACK_NONVOLATILE_REGISTERS Exibe o contexto de registro não volátil para cada quadro. Isso só é significativo para algumas plataformas.
DEBUG_STACK_FRAME_NUMBERS Exibe números de quadro.
DEBUG_STACK_PARAMETERS Exibe nomes e valores de parâmetros, conforme fornecido nas informações de símbolo.
DEBUG_STACK_FRAME_ADDRESSES_RA_ONLY Exibe apenas o endereço de retorno em endereços de quadro de pilha.
DEBUG_STACK_FRAME_MEMORY_USAGE Exibe o número de bytes que separam os quadros.
DEBUG_STACK_PARAMETERS_NEWLINE Exibe cada parâmetro e seu tipo e valor em uma nova linha.

Retornar valor

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

Código de retorno Descrição
S_OK
O método foi bem-sucedido.

Comentários

A matriz de quadros de pilha pode ser obtida usando GetStackTrace.

Requisitos

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

Confira também

GetContextStackTrace

GetStackTrace

Idebugcontrol

IDebugControl2

IDebugControl3

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