Интерфейс 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

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