Método IDebugControl5::OutputStackTraceEx (dbgeng.h)
O método OutputStackTraceEx gera o quadro de pilha fornecido ou os quadros de pilha atuais. O método OutputStackTraceEx 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 OutputStackTraceEx(
[in] ULONG OutputControl,
[in, optional] PDEBUG_STACK_FRAME_EX 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 |
---|---|
|
O método foi bem-sucedido. |
Comentários
A matriz de quadros de pilha pode ser obtida usando GetStackTraceEx.
Requisitos
Requisito | Valor |
---|---|
Plataforma de Destino | Área de Trabalho |
Cabeçalho | dbgeng.h (inclua Dbgeng.h) |