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

Artigo
02/27/2024

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.