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