Compartilhar via

Função de retorno de chamada ExtExtension::* ExtKnownStructMethod (engextcpp.hpp)

  • Artigo

O método de retorno de chamada ExtKnownStructMethod é chamado pelo mecanismo para formatar uma instância de uma estrutura para saída em uma única linha.

Sintaxe

ExtExtension::* ExtKnownStructMethod Extextension::*Extknownstructmethod;

void Extextension::*Extknownstructmethod(
  [in] PCSTR TypeName,
  [in] ULONG Flags,
  [in] ULONG64 Offset
)
{...}

Parâmetros

[in] TypeName

Especifica o nome do tipo da estrutura apontada por Offset. Isso é o mesmo que o campo TypeName da estrutura ExtKnownStruct usada para registrar esse método de retorno de chamada.

[in] Flags

Especifica sinalizadores de bits que indicam como a saída deve ser formatada. Atualmente, isso é definido como DEBUG_KNOWN_STRUCT_GET_SINGLE_LINE_OUTPUT, o que indica que a saída deve ser formatada para saída em uma única linha.

[in] Offset

Especifica o local na memória do destino da instância da estrutura a ser formatada para saída.

Retornar valor

Nenhum

Comentários

O mecanismo do depurador espera que a saída seja formatada para impressão em uma única linha, portanto, não espera que a estrutura formatada tenha quebras de linha.

A saída formatada desse método deve ser colocada no buffer m_AppendBuffer – um membro de ExtExtension.

Instâncias desse método de retorno de chamada são registradas com o mecanismo usando uma instância da estrutura ExtKnownStruct que é colocada na matriz m_KnownStructs (um membro de ExtExtension) pelo método Initialize . A estrutura ExtKnownStruct também especifica o nome do tipo de estrutura que esse método formata.

Quando o mecanismo do depurador chama um método de estrutura conhecido, ele encapsula a chamada em um bloco try/except . Isso protege o mecanismo contra alguns tipos de bugs no código de extensão; mas, como as chamadas de extensão são executadas no mesmo thread que o mecanismo, elas ainda podem fazer com que ela falhe.

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho engextcpp.hpp (inclua Engextcpp.hpp)

Confira também

ExtExtension

ExtKnownStruct

Initialize