Partilhar via

Estrutura MDAInfo

  • Artigo

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

Syntax

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

Membros

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

Observações

Os assistentes de depuração gerida (MDAs) são auxiliares de depuração que funcionam em conjunto com o runtime de linguagem comum (CLR) para executar tarefas como identificar condições inválidas no motor de execução de tempo de execução ou informações adicionais sobre o estado do motor. Os MDAs geram mensagens XML sobre eventos que de outra forma são difíceis de capturar. São especialmente úteis para depurar transições entre código gerido e não gerido.

O runtime segue os seguintes passos quando um evento que aciona a criação de um MDA é acionado:

  • Se o anfitrião não tiver registado uma instância IActionOnCLREvent ao chamar ICLROnEventManager::RegisterActionOnEvent para ser notificado de um Event_MDAFired evento, o runtime continua com o comportamento predefinido e não alojado.

  • Se o anfitrião tiver registado um processador para este evento, o runtime verifica se um depurador está anexado ao processo. Se for, o runtime entra no depurador. Quando o depurador continuar, chama para o anfitrião. Se não for anexado nenhum depurador, o runtime chama IActionOnCLREvent::OnEvent e transmite um ponteiro para uma MDAInfo instância como o data parâmetro.

O anfitrião pode optar por ativar MDAs e ser notificado quando um MDA é ativado. Isto dá ao anfitrião a oportunidade de substituir o comportamento predefinido e abortar o thread gerido que elevou o evento, para impedir que este corrompe o estado do processo. Para obter mais informações sobre como utilizar MDAs, veja Diagnosticar Erros com Assistentes de Depuração Gerida.

Requisitos

Plataformas: Veja Requisitos do Sistema.

Cabeçalho: MSCorEE.idl

Biblioteca: Incluído como um recurso no MSCorEE.dll

.NET Framework Versões: Disponível desde 2.0

Ver também