Интерфейс ICorProfilerInfo3
Предоставляет методы, используемые профилировщиками кода для обмена данными со средой CLR с целью управления мониторингом событий и запроса сведений. Интерфейс ICorProfilerInfo3 является расширением интерфейса ICorProfilerInfo2. Он предоставляет новые методы, поддерживаемые в платформе .NET Framework 4 и более поздних версиях.
Методы
Метод |
Описание |
|---|---|
Возвращает перечислитель для всех функций, JIT-скомпилированных ранее. |
|
Возвращает перечислитель, предоставляющий методы для последовательной итерации по коллекции управляемых модулей, загруженных в приложение. |
|
Получает идентификаторы доменов приложений, в которые был загружен указанный модуль. |
|
Предоставляет кадр стека и сведения об аргументах функции, предоставленные профилировщику функцией FunctionEnter3WithInfo; может вызываться только во время выполнения обратного вызова FunctionEnter3WithInfo. |
|
Предоставляет кадр стека и возвращаемое значение функции, предоставленные профилировщику функцией FunctionLeave3WithInfo function; может вызываться только во время выполнения обратного вызова FunctionLeave3WithInfo. |
|
Предоставляет кадр стека и сведения об аргументах функции, предоставленные профилировщику функцией FunctionTailcall3WithInfo; может вызываться только во время выполнения обратного вызова FunctionTailcall3WithInfo. |
|
Идентификатор модуля возвращает имя файла модуля, идентификатор родительской сборки модуля и битовую маску, описывающую свойства модуля. |
|
Предоставляет сведения о версии среды выполнения, для которой производится профилирование. |
|
Получает сведения о структуре строкового объекта. |
|
Получает адрес заданного статического поля потока, которое находится в области действия заданного потока и домена приложения. |
|
Дает среде выполнения команду на отключение профилировщика. |
|
Задает реализуемые профилировщиком функции, которые будут вызываться в функциях FunctionEnter3, FunctionLeave3 и FunctionTailcall3. |
|
Метод ICorProfilerInfo3::SetEnterLeaveFunctionHooks3WithInfo |
Задает реализуемые профилировщиком функции, которые будут вызываться в обработчиках и управляемых функциях FunctionEnter3WithInfo, FunctionLeave3WithInfo и FunctionTailcall3WithInfo. |
Задает реализуемую профилировщиком функцию, которая будет вызвана для сопоставления значений FunctionID альтернативным значениям, которые передаются обработчикам входа и выхода для функции профилировщика. Этот метод расширяет функцию ICorProfilerInfo::SetFunctionIDMapper, добавляя к ней параметр, с помощью которого профилировщики могут различать среды выполнения. |
Заметки
Среда CLR реализует методы интерфейса ICorProfilerInfo3 с помощью модели свободных потоков. Каждый метод возвращает HRESULT для обозначения успешного выполнения или сбоя. Список возможных кодов возврата см. в файле CorError.h.
Среда CLR передает интерфейс ICorProfilerInfo3 каждому профилировщику кода во время инициализации с помощью реализации метода ICorProfilerCallback::Initialize или ICorProfilerCallback3::InitializeForAttach этого профилировщика. Профилировщик кода затем может вызвать методы ICorProfilerInfo3 для получения информации по управляемому коду, выполняемому под управлением среды CLR.
Дополнительные сведения о значениях AppDomainID и FunctionID см. в разделе Идентификаторы уведомлений среды выполнения и профилирования.
Требования
Платформы: см. раздел Требования к системе для .NET Framework.
Заголовок: CorProf.idl, CorProf.h
Библиотека: CorGuids.lib
**Версии платформы .NET Framework: ** 4