Sdílet prostřednictvím

ICorProfilerInfo3 – rozhraní

  • Článek

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

Viz také