提供代码探查器与公共语言运行时 (CLR) 控制事件监视并请求信息进行通信的方法。
Note: 中的每个方法
ICorProfilerInfo接口返回一个 HRESULT,指示成功或失败。 可能的返回代码的列表,请参阅 CorError.h。
方法
| 方法 | 描述 |
|---|---|
| BeginInprocDebugging 方法 | 初始化在进程中调试支持。 此方法是在.NET Framework 2.0 版中已过时。 |
| EndInprocDebugging 方法 | 关闭进程内调试会话。 此方法是在.NET Framework 2.0 版中已过时。 |
| ForceGC 方法 | 在运行时内执行的强制垃圾回收。 |
| GetAppDomainInfo 方法 | 获取有关指定的应用程序域的信息。 |
| GetAssemblyInfo 方法 | 获取有关指定的程序集的信息。 |
| GetClassFromObject 方法 | 获取ClassID的 给定的对象及其ObjectID。 |
| GetClassFromToken 方法 | 获取给定元数据标记的类的 ID。 此方法是在.NET Framework 2.0 版中已过时。 使用ICorProfilerInfo2::GetClassFromTokenAndTypeArgs方法相反。 |
| GetClassIDInfo 方法 | 获取指定的类的父模块和元数据标记。 |
| GetCodeInfo 方法 | 获取与指定函数 ID 关联的本机代码的范围。 此方法已过时。 使用ICorProfilerInfo2::GetCodeInfo2方法相反。 |
| GetCurrentThreadID 方法 | 如果它是一个托管的线程,请获取当前线程的 ID。 |
| GetEventMask 方法 | 获取探查器要接收来自 CLR 的事件通知的当前事件类别。 |
| GetFunctionFromIP 方法 | 映射到的托管的代码指令指针FunctionID。 |
| GetFunctionFromToken 方法 | 获取函数的 ID。 此方法是在.NET Framework 2.0 版中已过时。 使用ICorProfilerInfo2::GetFunctionFromTokenAndTypeArgs方法相反。 |
| GetFunctionInfo 方法 | 获取父类和元数据令牌指定的函数。 |
| GetHandleFromThread 方法 | 映射到 Win32 线程句柄的线程 ID。 |
| GetILFunctionBody 方法 | 获取一个指针指向方法的主体在 Microsoft 中间语言 (MSIL) 代码中,从其标头处开始。 |
| GetILFunctionBodyAllocator 方法 | 获取提供的方法来分配内存来用于换出的 MSIL 代码中的方法主体的接口。 |
| GetILToNativeMapping 方法 | 获取到指定的函数中包含的代码的本机偏移量 MSIL 偏移量的映射。 |
| GetInprocInspectionInterface 方法 | ICorDebugProcess 接口获取可查询的对象。 此方法是在.NET Framework 2.0 版中已过时。 |
| GetInprocInspectionIThisThread 方法 | ICorDebugThread 接口获取可查询的对象。 此方法是在.NET Framework 2.0 版中已过时。 |
| GetModuleInfo 方法 | 给定模块 ID 后,将返回模块的文件名和模块的父程序集的 ID。 |
| GetModuleMetaData 方法 | 获取将映射到指定的模块的元数据接口实例。 |
| GetObjectSize 方法 | 获取指定对象的大小。 |
| GetThreadContext 方法 | 获取当前与指定的线程相关联的上下文标识。 |
| GetThreadInfo 方法 | 获取指定线程当前的 Win32 线程标识。 |
| GetTokenAndMetadataFromFunction 方法 | 获取元数据标记和可用于指定的函数对令牌的元数据接口的实例。 |
| IsArrayClass 方法 | 确定指定的类是否为数组类。 |
| SetEnterLeaveFunctionHooks 方法 | 指定要在"输入"、"保留"和"tailcall"挂钩的托管函数调用的探查器实现的函数。 |
| SetEventMask 方法 | 设置一个值,指定的事件探查器要接收来自 CLR 的通知类型。 |
| SetFunctionIDMapper 方法 | 指定将调用以将 FunctionID 值映射至替换值(传递至探查器的输入/退出挂钩)的探查器实现函数。 |
| SetFunctionReJIT 方法 | 未实现。 请勿使用。 |
| SetILFunctionBody 方法 | 替换指定的模块中的指定函数的正文。 |
| SetILInstrumentedCodeMap 方法 | 指定的偏移量指定的函数的原始 MSIL 如何映射到新的函数的探查器修改 MSIL 偏移量。 |
备注
探查器调用中的方法ICorProfilerInfo接口通信与 CLR 进行控制事件监视及请求信息。
方法ICorProfilerInfo由 CLR 使用自由线程模型实现接口。 每个方法均返回一个 HRESULT,指示成功或失败。 可能的返回代码的列表,请参阅 CorError.h。
CLR 探查器的实现通过传递icorprofilercallback:: Initialize、ICorProfilerInfo在初始化过程中每个代码探查器的接口。 然后,代码探查器可以调用的方法ICorProfilerInfo接口,用于获取有关正在执行 CLR 控制下的托管代码的信息。
要求
平台: 请参阅系统需求。
标头: CorProf.idl, CorProf.h
库: CorGuids.lib
**.NET Framework 版本:**自 2.0 之后可用
请参阅
历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者(原始作者元数据 mairaw)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站展开固定版本仓库内的引用内容,将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。
