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

Artigo
02/06/2025

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 pelo 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.

Valor de retorno

Nenhum

Observações

O mecanismo de 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 do ExtExtension.

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

Quando o mecanismo de depurador chama um método de estrutura conhecido, ele encapsula a chamada em uma tentativa de /exceto bloco. 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 causar uma falha.

Requisitos

Requisito	Valor
da Plataforma de Destino	Área de trabalho
cabeçalho	engextcpp.hpp (inclua Engextcpp.hpp)

Consulte também

extExtension

ExtKnownStruct

inicializar

Compartilhar via