Интерфейс IDebugHostContext (dbgmodel.h)
Представляет контекст отладчика, который отвечает на вопросы о (какой сеанс, процесс, поток).
Наследование
IDebugHostContext наследуется от IUnknown.
Методы
Интерфейс IDebugHostContext содержит следующие методы.
| IDebugHostContext::AddRef Метод IDebugHostContext::AddRef увеличивает количество ссылок для интерфейса в объекте . |
| IDebugHostContext::IsequalTo Возвращает значение, указывающее, равны ли два объекта IDebugHostContext по значению. |
| IDebugHostContext::QueryInterface Метод IDebugHostContext::QueryInterface извлекает указатели на поддерживаемые интерфейсы объекта . |
| IDebugHostContext::Release Метод IDebugHostContext::Release уменьшает количество ссылок для интерфейса объекта . |
Комментарии
Объекты контекста — это непрозрачные BLOB-объекты с информацией, которую узел отладки (в сотрудничестве с моделью данных) связывает с каждым объектом. Он может включать такие элементы, как контекст процесса или адресное пространство, из которых поступает информация, и т. д. Объект контекста — это реализация IDebugHostContext, упакованая в IModelObject.
Обратите внимание, что IDebugHostContext — это интерфейс, определяемый узлом. Клиент никогда не реализует этот интерфейс.
Контекст: адресное пространство
Важно отметить, что в отличие от предыдущих моделей расширения, в которых контекст (целевой объект, процесс, просматриваемые потоки) является концепцией пользовательского интерфейса со всеми API относительно текущего состояния пользовательского интерфейса, интерфейсы модели данных обычно принимают этот контекст явно или неявно как интерфейс IDebugHostContext. Каждый объект IModelObject в модели данных содержит сведения о контексте этого типа и может распространять этот контекст на возвращаемые объекты. Это означает, что при чтении собственного значения или ключевого значения из объекта IModelObject он считывает данные из целевого объекта и процесса, из которого изначально был получен объект. Существует явное значение константы, USE_CURRENT_HOST_CONTEXT, которое можно передать методам, принимаюющим аргумент IDebugHostContext. Это значение указывает, что контекст действительно должен быть текущим состоянием пользовательского интерфейса отладчика. Однако это понятие должно быть явным.
Требования
| Требование | Значение |
|---|---|
| Заголовок | dbgmodel.h |