Интерфейс ICorProfilerInfoICorProfilerInfo Interface

Предоставляет методы для использования профилировщиками кода для взаимодействия со средой CLR для управления мониторингом событий и сведениями о запросах.Provides methods for use by code profilers to communicate with the common language runtime (CLR) to control event monitoring and request information.

Примечание

Каждый метод в ICorProfilerInfo интерфейсе возвращает значение HRESULT для обозначения успеха или неудачи.Each method in the ICorProfilerInfo interface returns an HRESULT to indicate success or failure. Список возможных кодов возврата см. в разделе CorError. h.See CorError.h for a list of possible return codes.

МетодыMethods

МетодMethod ОписаниеDescription
Метод BeginInprocDebuggingBeginInprocDebugging Method Инициализирует поддержку внутрипроцессного отладки.Initializes in-process debugging support. Этот метод является устаревшим в платформа .NET Framework версии 2,0.This method is obsolete in the .NET Framework version 2.0.
Метод EndInprocDebuggingEndInprocDebugging Method Завершает работу внутрипроцессного сеанса отладки.Shuts down an in-process debugging session. Этот метод является устаревшим в платформа .NET Framework версии 2,0.This method is obsolete in the .NET Framework version 2.0.
Метод ForceGCForceGC Method Принудительное выполнение сборки мусора в среде выполнения.Forces garbage collection to occur within the runtime.
Метод GetAppDomainInfoGetAppDomainInfo Method Возвращает сведения об указанном домене приложения.Gets information about the specified application domain.
Метод GetAssemblyInfoGetAssemblyInfo Method Возвращает сведения о указанной сборке.Gets information about the specified assembly.
Метод GetClassFromObjectGetClassFromObject Method Возвращает объект ClassIDGets the ClassID of an

Объект, учитывая его свойство ObjectID .object, given its ObjectID.
Метод GetClassFromTokenGetClassFromToken Method Возвращает идентификатор класса по заданному маркеру метаданных.Gets the ID of the class, given the metadata token. Этот метод является устаревшим в платформа .NET Framework версии 2,0.This method is obsolete in the .NET Framework version 2.0. Используйте вместо этого метод ICorProfilerInfo2:: GetClassFromTokenAndTypeArgs .Use the ICorProfilerInfo2::GetClassFromTokenAndTypeArgs method instead.
Метод GetClassIDInfoGetClassIDInfo Method Возвращает родительский модуль и маркер метаданных для указанного класса.Gets the parent module and the metadata token for the specified class.
Метод GetCodeInfoGetCodeInfo Method Получает экстент машинного кода, связанного с указанным идентификатором функции.Gets the extent of native code associated with the specified function ID. Этот метод устарел.This method is obsolete. Используйте вместо этого метод ICorProfilerInfo2:: GetCodeInfo2 .Use the ICorProfilerInfo2::GetCodeInfo2 method instead.
Метод GetCurrentThreadIDGetCurrentThreadID Method Возвращает идентификатор текущего потока, если он является управляемым потоком.Gets the ID of the current thread, if it is a managed thread.
Метод GetEventMaskGetEventMask Method Возвращает текущие категории событий, для которых профилировщик хочет получать уведомления о событиях из среды CLR.Gets the current event categories for which the profiler wants to receive event notifications from the CLR.
Метод GetFunctionFromIPGetFunctionFromIP Method Сопоставляет указатель инструкции управляемого кода с FunctionID .Maps a managed code instruction pointer to a FunctionID.
Метод GetFunctionFromTokenGetFunctionFromToken Method Возвращает идентификатор функции.Gets the ID of a function. Этот метод является устаревшим в платформа .NET Framework версии 2,0.This method is obsolete in the .NET Framework version 2.0. Используйте вместо этого метод ICorProfilerInfo2:: жетфунктионфромтокенандтипеаргс .Use the ICorProfilerInfo2::GetFunctionFromTokenAndTypeArgs method instead.
Метод GetFunctionInfoGetFunctionInfo Method Возвращает родительский класс и токен метаданных для указанной функции.Gets the parent class and metadata token for the specified function.
Метод GetHandleFromThreadGetHandleFromThread Method Сопоставляет идентификатор потока с обработчиком потока Win32.Maps the ID of a thread to a Win32 thread handle.
Метод GetILFunctionBodyGetILFunctionBody Method Возвращает указатель на тело метода в коде на языке MSIL, начиная с его заголовка.Gets a pointer to the body of a method in Microsoft intermediate language (MSIL) code, starting at its header.
Метод GetILFunctionBodyAllocatorGetILFunctionBodyAllocator Method Возвращает интерфейс, предоставляющий метод для выделения памяти, используемой для перекачки тела метода в коде MSIL.Gets an interface that provides a method to allocate memory to be used for swapping out the body of a method in MSIL code.
Метод GetILToNativeMappingGetILToNativeMapping Method Возвращает карту из смещений MSIL в машинные смещения для кода, содержащегося в указанной функции.Gets a map from MSIL offsets to native offsets for the code contained in the specified function.
Метод GetInprocInspectionInterfaceGetInprocInspectionInterface Method Возвращает объект, к которому можно выполнить запрос для интерфейса ICorDebugProcess.Gets an object that can be queried for an ICorDebugProcess interface. Этот метод является устаревшим в платформа .NET Framework версии 2,0.This method is obsolete in the .NET Framework version 2.0.
Метод GetInprocInspectionIThisThreadGetInprocInspectionIThisThread Method Возвращает объект, для которого можно запросить интерфейс ICorDebugThread.Gets an object that can be queried for the ICorDebugThread interface. Этот метод является устаревшим в платформа .NET Framework версии 2,0.This method is obsolete in the .NET Framework version 2.0.
Метод GetModuleInfoGetModuleInfo Method Возвращает имя файла модуля и идентификатор его родительской сборки для указанного идентификатора модуля.Given a module ID, returns the file name of the module and the ID of the module's parent assembly.
Метод GetModuleMetaDataGetModuleMetaData Method Возвращает экземпляр интерфейса метаданных, сопоставляемый с указанным модулем.Gets a metadata interface instance that maps to the specified module.
Метод GetObjectSizeGetObjectSize Method Возвращает размер указанного объекта.Gets the size of a specified object.
Метод GetThreadContextGetThreadContext Method Возвращает удостоверение контекста, которое в настоящее время связано с указанным потоком.Gets the context identity currently associated with the specified thread.
Метод GetThreadInfoGetThreadInfo Method Возвращает текущее удостоверение потока Win32 для указанного потока.Gets the current Win32 thread identity for the specified thread.
Метод GetTokenAndMetadataFromFunctionGetTokenAndMetadataFromFunction Method Возвращает маркер метаданных и экземпляр интерфейса метаданных, который может использоваться для токена указанной функции.Gets the metadata token and an instance of the metadata interface that can be used against the token for the specified function.
Метод IsArrayClassIsArrayClass Method Определяет, является ли указанный класс классом массива.Determines whether the specified class is an array class.
Метод SetEnterLeaveFunctionHooksSetEnterLeaveFunctionHooks Method Задает реализованные профилировщиком функции, которые должны вызываться для обработчиков "Ввод", "Leave" и "таилкалл" управляемых функций.Specifies profiler-implemented functions to be called on "enter", "leave", and "tailcall" hooks of managed functions.
Метод SetEventMaskSetEventMask Method Задает значение, указывающее типы событий, для которых профилировщик хочет получать уведомления из среды CLR.Sets a value that specifies the types of events for which the profiler wants to receive notification from the CLR.
Метод SetFunctionIDMapperSetFunctionIDMapper Method Задает реализуемую профилировщиком функцию, которая будет вызвана для сопоставления значений FunctionID с альтернативными значениями, передаваемыми обработчикам входа и выхода для функции профилировщика.Specifies the profiler-implemented function that will be called to map FunctionID values to alternative values, which are passed to the profiler's function entry/exit hooks.
Метод SetFunctionReJITSetFunctionReJIT Method Не реализовано.Not implemented. Не используйте.Do not use.
Метод SetILFunctionBodySetILFunctionBody Method Заменяет тело указанной функции в указанном модуле.Replaces the body of the specified function in the specified module.
Метод SetILInstrumentedCodeMapSetILInstrumentedCodeMap Method Указывает, каким способом смещений исходной схемы MSIL указанной функции к новым смещениям MSIL-кода, измененного профилировщиком функции.Specifies how the offsets of a specified function's original MSIL map to the new offsets of the function's profiler-modified MSIL.

RemarksRemarks

Профилировщик вызывает метод в ICorProfilerInfo интерфейсе, чтобы взаимодействовать со средой CLR для управления мониторингом событий и сведениями о запросах.A profiler calls a method in the ICorProfilerInfo interface to communicate with the CLR to control event monitoring and request information.

Методы ICorProfilerInfo интерфейса реализуются средой CLR с помощью модели свободных потоков.The methods of the ICorProfilerInfo interface are implemented by the CLR using the free-threaded model. Каждый метод возвращает значение HRESULT, указывающее на успешное выполнение или сбой.Each method returns an HRESULT to indicate success or failure. Список возможных кодов возврата см. в разделе CorError. h.See CorError.h for a list of possible return codes.

Среда CLR передается через реализацию метода ICorProfilerCallback:: Initializeв профилировщике, ICorProfilerInfo интерфейс к каждому профилировщику кода во время инициализации.The CLR passes, via the profiler's implementation of ICorProfilerCallback::Initialize, an ICorProfilerInfo interface to each code profiler during initialization. Профилировщик кода может затем вызывать методы ICorProfilerInfo интерфейса для получения сведений об управляемом коде, выполняемом под управлением среды CLR.A code profiler can then call methods of the ICorProfilerInfo interface to get information about managed code being executed under the control of the CLR.

ТребованияRequirements

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

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

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

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

См. такжеSee also