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