ICorProfilerInfo3 介面

提供程式碼分析工具用於和 Common Language Runtime (CLR) 通訊,以控制事件監視以及要求資訊的方法。 ICorProfilerInfo3 介面是 ICorProfilerInfo2 介面的延伸模組。 它提供 .NET Framework 4 和更新版本中支援的新方法。

方法

方法 描述
EnumJITedFunctions 方法 傳回所有先前 JIT 編譯函式的列舉。
EnumModules 方法 傳回提供循序逐一查看 Managed 模組集合方法的列舉,其中該模組被載入至應用程式中。
GetAppDomainsContainingModule 方法 取得已載入指定模組之應用程式定義域的識別項。
GetFunctionEnter3Info 方法 提供藉由 FunctionEnter3WithInfo 函式報告給分析工具的函式之堆疊框架和引數資訊;僅可在 FunctionEnter3WithInfo 回呼期間被呼叫。
GetFunctionLeave3Info 方法 提供藉由 FunctionLeave3WithInfo 函式報告給分析工具的函式之堆疊框架和傳回值;僅可在 FunctionLeave3WithInfo 回呼期間被呼叫。
GetFunctionTailcall3Info 方法 提供藉由 FunctionTailcall3WithInfo 函式報告給分析工具的函式之堆疊框架;僅可在 FunctionTailcall3WithInfo 回呼期間被呼叫。
GetModuleInfo2 方法 提供模組 ID,傳回該模組的檔案名稱、此模組父代組件的 ID 和描述模組屬性的位元遮罩。
GetRuntimeInformation 方法 提供有關正在分析之執行階段的版本資訊。
GetStringLayout2 方法 取得字串物件配置的相關資訊。
GetThreadStaticAddress2 方法 取得指定執行緒靜態欄位的位址,這位於指定之執行緒和應用程式定義域的範圍內。
RequestProfilerDetach 方法 指示該執行階段中斷與分析工具的連結。
SetEnterLeaveFunctionHooks3 方法 指定分析工具實作函式,以在 FunctionEnter3FunctionLeave3FunctionTailcall3 函式中呼叫。
SetEnterLeaveFunctionHooks3WithInfo 方法 指定分析工具實作的函式,系統會在受控函式的 FunctionEnter3WithInfoFunctionLeave3WithInfoFunctionTailcall3WithInfo 掛勾中呼叫此函式。
SetFunctionIDMapper2 方法 指定將被呼叫來對應 FunctionID 值到替代值的程式碼剖析工具實作函式,這會被傳遞至分析工具函式進入/離開的攔截。 搭配分析工具可能會在執行階段中使用來使意義清楚的參數,此方法會擴充 ICorProfilerInfo::SetFunctionIDMapper

備註

藉由使用無限制執行緒模型,CLR 會實作 ICorProfilerInfo3 介面的方法。 每個方法會傳回 HRESULT,表示成功或失敗。 如需可能的傳回程式碼清單,請參閱 CorError.h 檔案。

在初始化期間,CLR 會使用 ICorProfilerCallback::InitializeICorProfilerCallback3::InitializeForAttach 方法的分析工具實作,傳遞 ICorProfilerInfo3 介面至每個程式碼分析工具。 然後程式碼分析工具可以呼叫 ICorProfilerInfo3 方法,以取得在 CLR 控制下執行的 Managed 程式碼之資訊。

規格需求

平台:請參閱系統需求

標頭: CorProf.idl、CorProf.h

程式庫:CorGuids.lib

.NET Framework版本:自 4 起可用

另請參閱