Compartilhar via

Estrutura MDAInfo

  • Artigo

Fornece detalhes sobre o evento Event_MDAFired, que dispara a criação de um MDA (assistente para depuração gerenciada ).

Sintaxe

typedef struct _MDAInfo {  
    LPCWSTR  lpMDACaption;  
    LPCWSTR  lpMDAMessage  
} MDAInfo;

Membros

Membro DESCRIÇÃO
lpMDACaption O título do MDA atual. O título descreve o tipo de falha que disparou o Event_MDAFired evento.
lpMDAMessage A mensagem de saída fornecida pelo MDA atual.

Comentários

Os MDAs (assistentes de depuração gerenciados) são auxiliares de depuração que funcionam em conjunto com o CLR (Common Language Runtime) para executar tarefas como identificar condições inválidas no mecanismo de execução de runtime ou despejar informações adicionais sobre o estado do mecanismo. Os MDAs geram mensagens XML sobre eventos que, de outra forma, são difíceis de capturar. Elas são especialmente úteis para depuração de transições entre código gerenciado e não gerenciado.

O runtime executa as seguintes etapas quando um evento que dispara a criação de um MDA é acionado:

  • Se o host não tiver registrado uma instância IActionOnCLREvent chamando ICLROnEventManager::RegisterActionOnEvent para ser notificado de um Event_MDAFired evento, o runtime continuará com seu comportamento padrão, não hospedado.

  • Se o host tiver registrado um manipulador para esse evento, o runtime verificará se um depurador está anexado ao processo. Se for, o runtime será dividido no depurador. Quando o depurador continua, ele chama o host. Se nenhum depurador estiver anexado, o runtime chamará IActionOnCLREvent::OnEvent e passará um ponteiro para uma MDAInfo instância como o data parâmetro.

O host pode optar por ativar MDAs e ser notificado quando um MDA é ativado. Isso dá ao host a oportunidade de substituir o comportamento padrão e anular o thread gerenciado que gerou o evento, para evitar que ele corrompa o estado do processo. Para saber mais sobre usar MDAs, confira Diagnosticar erros com assistentes de depuração gerenciada.

Requisitos

Plataformas: confira Requisitos do sistema.

Cabeçalho: MSCorEE.idl

Biblioteca: incluída como um recurso no MSCorEE.dll

Versões do .NET Framework: disponíveis desde 2.0

Confira também