Método ICorDebugManagedCallback2::MDANotification

  • Artigo

Fornece uma notificação de que a execução de código encontrou um MDA (assistente de depuração gerenciada) no aplicativo que está sendo depurado.

Sintaxe

HRESULT MDANotification(  
    [in] ICorDebugController  *pController,  
    [in] ICorDebugThread      *pThread,  
    [in] ICorDebugMDA         *pMDA  
);

Parâmetros

pController
[in] Um ponteiro para uma interface ICorDebugController que expõe o processo ou o domínio do aplicativo no qual o MDA ocorreu.

Um depurador não deve fazer nenhuma suposição sobre se o controlador é um processo ou um domínio de aplicativo, embora ele sempre possa consultar a interface para fazer uma determinação.

pThread
[in] Um ponteiro para uma interface ICorDebugThread que expõe o thread gerenciado no qual o evento de depuração ocorreu.

Se o MDA ocorreu em um thread não gerenciado, o valor de pThread será nulo.

Você deve obter a ID de thread do sistema operacional (SO) do próprio objeto MDA.

pMDA
[in] Um ponteiro para uma interface ICorDebugMDA que expõe as informações do MDA.

Comentários

Um MDA é um aviso heurístico e não requer nenhuma ação explícita do depurador, exceto para chamar ICorDebugController::Continuar para retomar a execução do aplicativo que está sendo depurado.

O CLR (Common Language Runtime) pode determinar quais MDAs são acionados e quais dados estão em qualquer MDA determinado a qualquer momento. Portanto, os depuradores não devem criar nenhuma funcionalidade que exija padrões MDA específicos.

Os MDAs podem ser colocados em fila e acionados logo após o MDA ser encontrado. Isso pode acontecer se o runtime precisar esperar até chegar a um ponto seguro para disparar o MDA, em vez de disparar o MDA quando o encontrar. Isso também significa que o runtime pode disparar um número de MDAs em um único conjunto de retornos de chamada enfileirados (semelhante a uma operação de evento "attach").

Um depurador deve liberar a referência a uma instância ICorDebugMDA imediatamente após retornar do retorno de chamada MDANotification, para permitir que o CLR recicle a memória consumida por um MDA. A liberação da instância poderá melhorar o desempenho se muitos MDAs estiverem sendo acionados.

Requisitos

Plataformas: confira Requisitos do sistema.

Cabeçalho: CorDebug.idl, CorDebug.h

Biblioteca: CorGuids.lib

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

Confira também