Интерфейс ICorProfilerInfo

  • Статья

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

Примечание.

Каждый метод в интерфейсе ICorProfilerInfo возвращает HRESULT, указывающий на успех или сбой. Список возможных кодов возврата см. в CorError.h.

Методы

Метод Description
Метод BeginInprocDebugging Инициализирует поддержку отладки в процессе. Этот метод устарел в платформа .NET Framework версии 2.0.
Метод EndInprocDebugging Завершает сеанс отладки в процессе. Этот метод устарел в платформа .NET Framework версии 2.0.
Метод ForceGC Принудительно выполняет сборку мусора в среде выполнения.
Метод GetAppDomainInfo Возвращает сведения о указанном домене приложения.
Метод GetAssemblyInfo Возвращает сведения об указанной сборке.
Метод GetClassFromObject ClassID Возвращает объект

объект, учитывая его ObjectID.
Метод GetClassFromToken Возвращает идентификатор класса, учитывая маркер метаданных. Этот метод устарел в платформа .NET Framework версии 2.0. Используйте вместо этого метод ICorProfilerInfo2::GetClassFromTokenAndTypeArgs.
Метод GetClassIDInfo Возвращает родительский модуль и маркер метаданных для указанного класса.
Метод GetCodeInfo Получает экстент машинного кода, связанного с указанным идентификатором функции. Этот метод устарел. Вместо этого используйте метод ICorProfilerInfo2::GetCodeInfo2.
Метод GetCurrentThreadID Возвращает идентификатор текущего потока, если он является управляемым потоком.
Метод GetEventMask Возвращает текущие категории событий, для которых профилировщик хочет получать уведомления о событиях из среды CLR.
Метод GetFunctionFromIP Карты указатель FunctionIDна инструкцию управляемого кода.
Метод GetFunctionFromToken Возвращает идентификатор функции. Этот метод устарел в платформа .NET Framework версии 2.0. Используйте вместо этого метод ICorProfilerInfo2::GetFunctionFromTokenAndTypeArgs.
Метод GetFunctionInfo Возвращает родительский класс и маркер метаданных для указанной функции.
Метод GetHandleFromThread Карты идентификатор потока в дескриптор потока Win32.
Метод GetILFunctionBody Получает указатель на текст метода в коде общего промежуточного языка (CIL), начиная с заголовка.
Метод GetILFunctionBodyAllocator Возвращает интерфейс, предоставляющий метод выделения памяти для замены текста метода в коде CIL.
Метод GetILToNativeMapping Возвращает карту из смещения CIL к собственным смещениям для кода, содержащегося в указанной функции.
Метод GetInprocInspectionInterface Возвращает объект, который можно запросить для интерфейса ICorDebugProcess. Этот метод устарел в платформа .NET Framework версии 2.0.
Метод GetInprocInspectionIThisThread Возвращает объект, который можно запросить для интерфейса ICorDebugThread. Этот метод устарел в платформа .NET Framework версии 2.0.
Метод GetModuleInfo Возвращает имя файла модуля и идентификатор его родительской сборки для указанного идентификатора модуля.
Метод GetModuleMetaData Возвращает экземпляр интерфейса метаданных, который сопоставляется с указанным модулем.
Метод GetObjectSize Возвращает размер указанного объекта.
Метод GetThreadContext Возвращает удостоверение контекста, связанное с указанным потоком.
Метод GetThreadInfo Возвращает текущее удостоверение потока Win32 для указанного потока.
Метод GetTokenAndMetadataFromFunction Возвращает маркер метаданных и экземпляр интерфейса метаданных, который можно использовать против маркера для указанной функции.
Метод IsArrayClass Определяет, является ли указанный класс классом массива.
Метод SetEnterLeaveFunctionHooks Указывает функции, реализованные профилировщиком, которые будут вызываться на перехватчиках управляемых функций ввод, "оставить" и "tailcall".
Метод SetEventMask Задает значение, указывающее типы событий, для которых профилировщик хочет получать уведомления от среды CLR.
Метод SetFunctionIDMapper Задает реализуемую профилировщиком функцию, которая будет вызвана для сопоставления значений FunctionID с альтернативными значениями, передаваемыми обработчикам входа и выхода для функции профилировщика.
Метод SetFunctionReJIT Не реализовано. Не используйте.
Метод SetILFunctionBody Заменяет текст указанной функции в указанном модуле.
Метод SetILInstrumentedCodeMap Указывает, как смещения исходной карты CIL указанной функции сопоставляются с новыми смещениями измененного профилировщиком функции CIL.

Замечания

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

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

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

Требования

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

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

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

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

См. также