Интерфейс ICorProfilerInfo2

  • Статья

Предоставляет методы, которые профилировщики кода используют для взаимодействия со средой CLR для управления мониторингом событий и запроса информации. Интерфейс ICorProfilerInfo2 является расширением интерфейса ICorProfilerInfo . Это значит, что он предоставляет новые методы, поддерживаемые в платформа .NET Framework версии 2.0 и более поздних версий.

Методы

Метод Описание
Метод DoStackSnapshot Выполняет пошаговое руководство по стеку указанного потока, чтобы сообщить об управляемых кадрах вызовов профилировщику.
Метод EnumModuleFrozenObjects Возвращает перечислитель, разрешающий итерацию по замороженным объектам в указанном модуле.
Метод GetAppDomainStaticAddress Возвращает адрес указанного статического поля домена приложения, которое находится в область указанного домена приложения.
Метод GetArrayObjectInfo Возвращает подробные сведения об объекте массива.
Метод GetBoxClassLayout Возвращает сведения о макете класса для указанного типа значения, который упаковывается.
Метод GetClassFromTokenAndTypeArgs ClassID Возвращает тип с использованием указанного маркера метаданных и ClassID значений аргументов типа.
Метод GetClassIDInfo2 Возвращает родительский модуль указанного универсального класса, маркер метаданных для класса, ClassID объект его родительского класса и ClassID для каждого аргумента типа класса , если он имеется.
Метод GetClassLayout Получает сведения о макете в памяти полей, определенных с помощью указанного класса. То есть этот метод получает смещения полей класса.
Метод GetCodeInfo2 Получает экстенты машинного кода, связанного с указанным FunctionID.
Метод GetContextStaticAddress Возвращает адрес указанного статического поля контекста, на область указанного контекста.
Метод GetFunctionFromTokenAndTypeArgs FunctionID Возвращает объект функции с использованием указанного маркера метаданных, содержащего класс и ClassID значения аргументов любого типа.
Метод GetFunctionInfo2 Получает родительский класс, токен метаданных и ClassID для каждого аргумента типа функции при их наличии.
Метод GetGenerationBounds Возвращает области памяти (сегменты кучи), которые составляют поколения кучи, собранной мусором.
Метод GetNotifiedExceptionClauseInfo Возвращает собственный адрес и сведения о фрейме для предложения исключения (catch//finallyfilter), которое должно быть выполнено или только что было выполнено.
Метод GetObjectGeneration Возвращает сегмент кучи, содержащий указанный объект .
Метод GetRVAStaticAddress Возвращает адрес указанного статического поля относительного виртуального адреса (RVA).
Метод GetStaticFieldInfo Возвращает область, в котором указанное поле является статическим.
Метод GetStringLayout Получает сведения о структуре строкового объекта.
Метод GetThreadAppDomain Возвращает идентификатор домена приложения, в котором указанный поток в настоящее время выполняет код.
Метод GetThreadStaticAddress Возвращает адрес указанного статического поля потока, которое находится в область указанного потока.
Метод SetEnterLeaveFunctionHooks2 Указывает функции, реализованные профилировщиком, которые будут вызываться для перехватчиков "ввод", "leave" и "tailcall" управляемых функций.

Комментарии

Профилировщик вызывает метод в интерфейсе ICorProfilerInfo2 для взаимодействия со средой CLR для управления мониторингом событий и запроса сведений.

Методы ICorProfilerInfo2 интерфейса реализуются средой CLR с помощью модели со свободным потоком. Каждый метод возвращает значение HRESULT, указывающее на успешное выполнение или сбой. Список возможных кодов возврата см. в файле CorError.h.

Среда CLR передает ICorProfilerInfo2 интерфейс каждому профилировщику кода во время инициализации, используя реализацию профилировщика ICorProfilerCallback::Initialize. Затем профилировщик кода может вызывать методы ICorProfilerInfo2 интерфейса для получения сведений об управляемом коде, выполняемом под управлением среды CLR.

Требования

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

Заголовок: CorProf.idl, CorProf.h

Библиотека: CorGuids.lib

версии платформа .NET Framework: доступно с версии 2.0.

См. также раздел