Поделиться через


Структура MDAInfo

Предоставляет сведения о событии Event_MDAFired, которое инициирует создание управляемого помощника по отладке (MDA).

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

Члены

Элемент

Описание

lpMDACaption

Название текущего MDA. Название описывает тип сбоя, вызвавшего событие Event_MDAFired.

lpMDAMessage

Выходное сообщение, предоставленное текущим MDA.

Заметки

Управляемые помощники отладки (MDA) являются вспомогательными средствами отладки, работающими совместно с средой CLR для выполнения таких задач, как идентификация недопустимых состояний в ядре выполнения среды выполнения и создание дампов дополнительной информации состояния ядра. MDA генерируют XML-сообщения о событиях, использование ловушек для которых может быть затруднено при использовании других способов. Они особенно полезны для отладки переходов между управляемым и неуправляемым кодом.

Данная среда выполнения предпринимает следующие шаги при вызове события, активировавшего создание MDA:

  • Если узел не зарегистрировал экземпляр IActionOnCLREvent путем вызова ICLROnEventManager::RegisterActionOnEvent, оповещаемого о событии Event_MDAFired, среда выполнения будет использовать поведение по умолчанию, не относящееся к узлу.

  • Если узел зарегистрировал обработчик для данного события, среда выполнения проверяет наличие вложенного в процесс отладчика. При его наличии среда выполнения входит в отладчик. При продолжении действий отладчиком производится вызов узла. Если отладчик не вложен, среда выполнения вызывает IActionOnCLREvent::OnEvent и передает указатель экземпляру MDAInfo в качестве параметра data.

Узел может активировать MDA и получать оповещение при активации MDA. Это дает узлу возможность переопределять состояние по умолчанию и отвергает управляемый поток, вызвавший событие, для предотвращения повреждения состояния процесса. Дополнительные сведения об использовании MDA см. в разделе Диагностика ошибок посредством управляемых помощников по отладке.

Требования

Платформы: см. раздел Требования к системе для .NET Framework.

Заголовок: MSCorEE.idl

Библиотека: включена как ресурс в MSCorEE.dll

Версии платформы .NET Framework: 4, 3.5 с пакетом обновления 1 (SP1), 3.5, 3.0 с пакетом обновления 1 (SP1), 3.0, 2.0 с пакетом обновления 1 (SP1), 2.0

См. также

Основные понятия

Диагностика ошибок посредством управляемых помощников по отладке

Другие ресурсы

Структуры размещения