Интерфейс ICorProfilerInfo
Предоставляет методы для использования профилировщиками кода для сообщения со средой CLR с целью управления мониторингом событий и запроса информации.
.gif "Примечание") Примечание |
|---|
Все методы в интерфейсе ICorProfilerInfo возвращают HRESULT для указания успешности или неуспешности выполнения.Список возможных возвращаемых кодов приведен в CorError.h. |
Методы
Метод |
Описание |
|---|---|
Инициализирует внутрипроцессную поддержку отладки. Этот метод является устаревшим для платформы .NET Framework версии 2.0. |
|
Завершает внутрипроцессный сеанс отладки. Этот метод является устаревшим для платформы .NET Framework версии 2.0. |
|
Принудительно запускает сборку мусора в рабочей среде. |
|
Получает информацию об указанном домене приложений. |
|
Получает сведения об указанной сборке. |
|
Получает ClassID объекта с его ObjectID. |
|
Получает идентификатор класса по заданному маркеру метаданные. Этот метод является устаревшим для платформы .NET Framework версии 2.0. Вместо него следует использовать метод ICorProfilerInfo2::GetClassFromTokenAndTypeArgs. |
|
Получает родительский модуль и маркер метаданных для указанного класса. |
|
Получает область памяти машинного кода, связанного с указанным идентификатором функции. Этот метод устарел. Вместо него следует использовать метод ICorProfilerInfo2::GetCodeInfo2. |
|
Получает идентификатор текущего потока, если этот поток является управляемым. |
|
Получает текущие категории событий, для которых профилировщик будет получать оповещения о событиях от среды CLR. |
|
Соотносит указатель инструкции управляемого кода с FunctionID. |
|
Получает идентификатор функции. Этот метод является устаревшим для платформы .NET Framework версии 2.0. Вместо него следует использовать метод ICorProfilerInfo2::GetFunctionFromTokenAndTypeArgs. |
|
Получает родительский класс и маркер метаданных для указанной функции. |
|
Сопоставляет идентификатор потока дескриптору потока Win32. |
|
Получает указатель основной части метода в коде MSIL (начиная с его заголовка). |
|
Получает интерфейс, предоставляющий метод для выделения памяти с целью использования при выгрузке основной части метода в коде MSIL. |
|
Получает сопоставление от смещений MSIL к машинным смещениям для кода, содержащегося в указанной функции. |
|
Получает объект, который можно запросить для интерфейса ICorDebugProcess. Этот метод является устаревшим для платформы .NET Framework версии 2.0. |
|
Получает объект, который может запрашиваться для интерфейса ICorDebugThread. Этот метод является устаревшим для платформы .NET Framework версии 2.0. |
|
Получая идентификатор модуля, возвращает имя файла модуля и идентификатор его родительской сборки. |
|
Получает экземпляр интерфейса метаданных, сопоставляемый с указанным модулем. |
|
Получает размер указанного объекта. |
|
Получает идентификацию контекста, в настоящее время связанную с указанным потоком. |
|
Получает текущую идентификацию потока Win32 для указанного потока. |
|
Получает маркер метаданных и экземпляр интерфейса метаданных, который может использоваться в отношении маркера для указанной функции. |
|
Определяет, является ли указанный класс классом массива. |
|
Задает реализуемые профилировщиком функции, вызываемые для обработчиков управляемых функций enter, leave и tailcall. |
|
Устанавливает значение, указывающее типы событий, для которых профилировщику требуется получать оповещения от среды CLR. |
|
Задает реализуемую профилировщиком функцию, которая будет вызвана для сопоставления значений FunctionID альтернативным значениям, которые передаются обработчикам входа и выхода для функции профилировщика. |
|
Не реализуется. Не используется. |
|
Заменяет основную часть указанной функции в указанном модуле. |
|
Указывает, каким образом смещения исходного сопоставления MSIL указанной функции с новыми смещениями изменяемого профилировщиком MSIL функции. |
Заметки
Профилировщик вызывает метод в интерфейсе ICorProfilerInfo для обмена данными со средой CLR с целью управления мониторингом событий и запроса сведений.
Методы интерфейса ICorProfilerInfo реализуются средой CLR с помощью модели свободных потоков. Каждый метод возвращает HRESULT для обозначения успешного выполнения или сбоя. Список возможных возвращаемых кодов приведен в CorError.h.
Среда CLR посредством реализацииICorProfilerCallback::Initialize профилировщика передает интерфейс ICorProfilerInfo каждому профилировщику кода в процессе инициализации. Профилировщик кода затем может вызвать методы интерфейса ICorProfilerInfo для получения информации по управляемому коду, выполняемому под управлением среды CLR.
Требования
Платформы: см. раздел Требования к системе для .NET Framework.
Заголовок: CorProf.idl, CorProf.h
Библиотека: CorGuids.lib
Версии платформы .NET Framework: 4, 3.5 с пакетом обновления 1 (SP1), 3.5, 3.0 с пакетом обновления 1 (SP1), 3.0, 2.0 с пакетом обновления 1 (SP1), 2.0