Интерфейс IHostDataModelAccess (dbgmodel.h)

2025-02-06

При вызове DebugExtensionInitialize создается клиент отладки и получает доступ к модели данных. Такой доступ предоставляется интерфейсом моста между устаревшими интерфейсами IDebug* средств отладки для Windows и моделью данных. Этот интерфейс моста — IHostDataModelAccess.

Наследство

IHostDataModelAccess наследует от IUnknown.

Методика

Интерфейс IHostDataModelAccess имеет эти методы.


IHostDataModelAccess::AddRef Метод IHostDataModelAccess::AddRef увеличивает число ссылок для интерфейса объекта.
IHostDataModelAccess::GetDataModel Метод GetDataModel — это метод интерфейса моста, предоставляющий доступ к обеим сторонам модели данных.
IHostDataModelAccess::QueryInterface Метод IHostDataModelAccess::QueryInterface извлекает указатели на поддерживаемые интерфейсы объекта.
IHostDataModelAccess::Release Метод IHostDataModelAccess::Release уменьшает количество ссылок для интерфейса объекта.

Замечания

Интерфейс предложил в механизме расширяемости узла для получения от механизма расширяемости узла к модели. Расширения, записанные в набор API для конкретного узла, могут запрашивать этот механизм, чтобы получить модель данных и создать расширения, не зависящие от узла.

Например, расширения на основе DbgEng могут запрашивать этот интерфейс из любого интерфейса IDebug* (Client/Control/etc...), чтобы перейти к API модели и модели доступа. Такие расширения являются гибридными (они по-прежнему относятся к конкретному узлу, но содержат части, которые могут быть факторированы позже для общего расширения на основе модели).

Это интерфейс ТОЛЬКО в этом наборе API, который не предназначен для размещения неустрачен.

Требования

Требование	Ценность
заголовка	dbgmodel.h

См. также

Обзор модели данных отладчика C++