ICorProfilerInfo3 – rozhraní
Poskytuje metody, které profilátory kódu používají ke komunikaci s modulem CLR (Common Language Runtime) k řízení monitorování událostí a k vyžádání informací. Rozhraní ICorProfilerInfo3 je rozšíření rozhraní ICorProfilerInfo2 . Poskytuje nové metody podporované v rozhraní .NET Framework 4 a novějších verzích.
Metody
| Metoda | Popis |
|---|---|
| EnumJITedFunctions – metoda | Vrátí enumerátor pro všechny dříve zkompilované funkce JIT. |
| EnumModules – metoda | Vrátí enumerátor, který poskytuje metody pro postupné iterace prostřednictvím kolekce spravovaných modulů, které jsou načteny do aplikace. |
| GetAppDomainsContainingModule – metoda | Získá identifikátory domén aplikace, ve kterých byl načten daný modul. |
| GetFunctionEnter3Info – metoda | Poskytuje zásobník rámec a argument informace funkce, který je hlášen profiler FunctionEnter3WithInfo funkce; lze volat pouze během zpětného FunctionEnter3WithInfo volání. |
| GetFunctionLeave3Info – metoda | Poskytuje zásobník rámec a návrat hodnotu funkce, která je hlášen profiler function FunctionLeave3WithInfo funkce ; lze volat pouze během zpětného FunctionLeave3WithInfo volání. |
| GetFunctionTailcall3Info – metoda | Poskytuje rámec zásobníku funkce, která je hlášen profiler FunctionTailcall3WithInfo funkce; lze volat pouze během zpětného FunctionTailcall3WithInfo volání. |
| GetModuleInfo2 – metoda | V případě ID modulu vrátí název souboru modulu, ID nadřazeného sestavení modulu a bitovou masku, která popisuje vlastnosti modulu. |
| GetRuntimeInformation – metoda | Poskytuje informace o verzi modulu runtime, který je profilován. |
| GetStringLayout2 – metoda | Získá informace o rozložení objektu řetězce. |
| GetThreadStaticAddress2 – metoda | Získá adresu zadaného pole thread-static, který je v oboru zadaného vlákna a domény aplikace. |
| RequestProfilerDetach – metoda | Dá modulu runtime pokyn, aby odpojil profiler. |
| SetEnterLeaveFunctionHooks3 – metoda | Určuje funkce implementované profilerem, které budou volána funkce FunctionEnter3, FunctionLeave3 a FunctionTailcall3 . |
| SetEnterLeaveFunctionHooks3WithInfo – metoda | Určuje funkce implementované profilerem, které budou volány v hácích spravovaných funkcí FunctionEnter3WithInfo, FunctionLeave3WithInfo a FunctionTailcall3WithInfo . |
| SetFunctionIDMapper2 – metoda | Určuje funkci implementovanou profilerem, která bude volána k mapování FunctionID hodnot na alternativní hodnoty, které se předávají vstupním a výstupním hookům funkce profileru. Tato metoda rozšiřuje ICorProfilerInfo::SetFunctionIDMapper o parametr, který profilátory mohou použít k nejednoznačnosti mezi moduly runtime. |
Poznámky
CLR implementuje metody ICorProfilerInfo3 rozhraní pomocí modelu s volnými vlákny. Každá metoda vrátí hodnotu HRESULT označující úspěch nebo selhání. Seznam možných návratových kódů najdete v souboru CorError.h.
CLR předává rozhraní každému ICorProfilerInfo3 profileru kódu během inicializace pomocí profileru implementace profileru ICorProfilerCallback::Initialize nebo ICorProfilerCallback3::InitializeForAttach metoda. Profiler kódu pak může volat ICorProfilerInfo3 metody pro získání informací o spravovaném kódu, který se spouští pod kontrolou CLR.
Požadavky
Platformy: Viz Požadavky na systém.
Záhlaví: CorProf.idl, CorProf.h
Knihovny: CorGuids.lib
Verze rozhraní .NET Framework: K dispozici od 4
