ICorProfilerInfo 介面

  • 發行項

提供程式代碼分析工具用來與 Common Language Runtime （CLR） 通訊的方法，以控制事件監視和要求資訊。

注意

介面中的每個 ICorProfilerInfo 方法都會傳回 HRESULT，指出成功或失敗。 如需可能的傳回碼清單，請參閱 CorError.h。

方法

方法 描述
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 方法 地圖的Managed程式代碼指令指標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 方法 根據模組 ID，傳回模組的檔案名稱和模組的父組件 ID。
GetModuleMetaData 方法 取得對應至指定模組的元數據介面實例。
GetObjectSize 方法 取得指定物件的大小。
GetThreadContext 方法 取得目前與指定線程相關聯的內容識別。
GetThreadInfo 方法 取得指定線程的目前 Win32 線程識別。
GetTokenAndMetadataFromFunction 方法 取得元數據令牌和元數據介面的實例，該介面可用於指定函式的令牌。
IsArrayClass 方法 判斷指定的類別是否為陣列類別。
SetEnterLeaveFunctionHooks 方法 指定要在 Managed 函式的 「enter」、“leave” 和 “tailcall” 攔截上呼叫分析工具實作的函式。
SetEventMask 方法 設定值，指定分析工具想要從 CLR 接收通知的事件類型。
SetFunctionIDMapper 方法 指定將被呼叫來對應 FunctionID 值到替代值的程式碼剖析工具實作函式，這會被傳遞至分析工具函式進入/離開的攔截。
SetFunctionReJIT 方法 未實作。 請勿使用。
SetILFunctionBody 方法 取代指定模組中指定函式的主體。
SetILInstrumentedCodeMap 方法 指定指定函式原始 CIL 的位移如何對應至函式分析工具修改 CIL 的新位移。

備註

分析工具會在介面中 ICorProfilerInfo 呼叫 方法來與 CLR 通訊，以控制事件監視和要求資訊。

介面的方法 ICorProfilerInfo 是由 CLR 使用自由線程模型實作。 每個方法會傳回 HRESULT，表示成功或失敗。 如需可能的傳回碼清單，請參閱 CorError.h。

CLR 會透過分析工具的 ICorProfilerCallback：：InitializeICorProfilerInfo 實作，傳遞初始化期間每個程式碼分析工具的介面。 然後，程式代碼分析工具可以呼叫 介面的方法 ICorProfilerInfo ，以取得CLR控制下所執行Managed程式碼的相關信息。

需求

平台：請參閱系統需求。

標頭： CorProf.idl、CorProf.h

程式庫：CorGuids.lib

.NET Framework 版本： 自 2.0 起提供

另請參閱