ICorProfilerInfo3 介面

提供方法讓程式碼分析工具用來與 Common Language Runtime (CLR) 通訊，以控制事件監視及要求資訊。 ICorProfilerInfo3 介面是 ICorProfilerInfo2 介面的擴充。 它提供了 .NET Framework 4 版 (含) 以後版本所支援的新方法。

方法

方法	描述
ICorProfilerInfo3::EnumJITedFunctions 方法	為所有先前 JIT 編譯的函式傳回列舉程式。
ICorProfilerInfo3::EnumModules 方法	傳回列舉程式，這個列舉程式會提供方法，以便循序逐一查看載入應用程式之 Managed 模組的集合。
ICorProfilerInfo3::GetAppDomainsContainingModule 方法	取得已載入指定之模組的應用程式定義域的識別項。
ICorProfilerInfo3::GetFunctionEnter3Info 方法	提供由 FunctionEnter3WithInfo 函式報告至分析工具的函式堆疊框架和引數資訊，對此函式只可在進行 FunctionEnter3WithInfo 回呼期間呼叫。
ICorProfilerInfo3::GetFunctionLeave3Info 方法	提供由 FunctionLeave3WithInfo 函式報告至分析工具的函式堆疊框架和傳回值，對此函式只可在進行 FunctionLeave3WithInfo 回呼期間呼叫。
ICorProfilerInfo3::GetFunctionTailcall3Info 方法	提供由 FunctionTailcall3WithInfo 函式報告至分析工具的函式堆疊框架和引數資訊，對此函式只可在進行 FunctionTailcall3WithInfo 回呼期間呼叫。
ICorProfilerInfo3::GetModuleInfo2 方法	擁有指定的模組 ID，並傳回模組的檔案名稱、該模組之父組件的 ID，以及描述模組之屬性的位元遮罩。
ICorProfilerInfo3::GetRuntimeInformation 方法	提供有關正在分析之執行階段的版本資訊。
ICorProfilerInfo3::GetStringLayout2 方法	取得字串物件的配置資訊。
ICorProfilerInfo3::GetThreadStaticAddress2 方法	取得指定之執行緒靜態欄位的位址，該欄位是在指定的執行緒和應用程式定義域的範圍內。
ICorProfilerInfo3::RequestProfilerDetach 方法	指示執行階段將分析工具中斷連結。
ICorProfilerInfo3::SetEnterLeaveFunctionHooks3 方法	指定程式碼剖析工具實作函式，這些將會在 FunctionEnter3、FunctionLeave3 和 FunctionTailcall3 函式中呼叫。
ICorProfilerInfo3::SetEnterLeaveFunctionHooks3WithInfo 方法	指定程式碼剖析工具實作函式，這些將會在 Managed 函式的 FunctionEnter3WithInfo、FunctionLeave3WithInfo 和 FunctionTailcall3WithInfo 攔截程序中呼叫。
ICorProfilerInfo3::SetFunctionIDMapper2 方法	指定將呼叫的分析工具實作函式，以便將 FunctionID 值對應至替代值，這些值會傳遞至分析工具的 entry/exit 攔截程序。 這個方法用來擴充 ICorProfilerInfo::SetFunctionIDMapper 的參數，是分析工具可能用來清楚識別執行階段的參數。

備註

CLR 會使用無限制執行緒模型，來實作 ICorProfilerInfo3 介面的方法。 每個方法都會傳回 HRESULT 以表示成功或失敗。 如需可能的傳回碼 (Return Code) 清單，請參閱 CorError.h 檔案。

CLR 會使用分析工具的 ICorProfilerCallback::Initialize 實作或 ICorProfilerCallback3::InitializeForAttach 方法，在初始化期間將 ICorProfilerInfo3 介面傳遞至每個程式碼分析工具。 接著，程式碼分析工具就可以呼叫 ICorProfilerInfo3 方法，以取得在 CLR 控制下執行之 Managed 程式碼的相關資訊。

如需 AppDomainID 和 FunctionID 值的詳細資訊，請參閱分析和執行階段通知識別碼。

需求

**平台：**請參閱 .NET Framework 系統需求。

**標頭：**CorProf.idl、CorProf.h

**程式庫：**CorGuids.lib

.NET Framework 版本：  4

請參閱

參考

ICorProfilerInfo 介面

其他資源

分析介面