Sdílet prostřednictvím

ICorProfilerInfo – rozhraní

  • Článek

Poskytuje metody pro použití profilátory kódu ke komunikaci s modulem CLR (Common Language Runtime) k řízení monitorování událostí a vyžádání informací.

Poznámka:

Každá metoda v ICorProfilerInfo rozhraní vrátí HRESULT označující úspěch nebo selhání. Seznam možných návratových kódů najdete v části CorError.h.

Metody

metoda Popis
BeginInprocDebugging – metoda Inicializuje podporu ladění v procesu. Tato metoda je zastaralá v rozhraní .NET Framework verze 2.0.
EndInprocDebugging – metoda Vypne relaci ladění v procesu. Tato metoda je zastaralá v rozhraní .NET Framework verze 2.0.
ForceGC – metoda Vynutí uvolňování paměti, aby došlo v rámci modulu runtime.
GetAppDomainInfo – metoda Získá informace o zadané doméně aplikace.
GetAssemblyInfo – metoda Získá informace o zadaném sestavení.
GetClassFromObject – metoda ClassID Získá z

objektu, s ohledem na jeho ObjectID.
GetClassFromToken – metoda Získá ID třídy vzhledem k tokenu metadat. Tato metoda je zastaralá v rozhraní .NET Framework verze 2.0. Místo toho použijte metodu ICorProfilerInfo2::GetClassFromTokenAndTypeArgs .
GetClassIDInfo – metoda Získá nadřazený modul a token metadat pro zadanou třídu.
GetCodeInfo – metoda Získá rozsah nativního kódu přidruženého k zadanému ID funkce. Tato metoda je zastaralá. Místo toho použijte metodu ICorProfilerInfo2::GetCodeInfo2 .
GetCurrentThreadID – metoda Získá ID aktuálního vlákna, pokud se jedná o spravované vlákno.
GetEventMask – metoda Získá aktuální kategorie událostí, pro které profiler chce přijímat oznámení událostí z CLR.
GetFunctionFromIP – metoda Mapy ukazatel instrukce spravovaného kódu na .FunctionID
GetFunctionFromToken – metoda Získá ID funkce. Tato metoda je zastaralá v rozhraní .NET Framework verze 2.0. Místo toho použijte metodu ICorProfilerInfo2::GetFunctionFromTokenAndTypeArgs .
GetFunctionInfo – metoda Získá nadřazenou třídu a token metadat pro zadanou funkci.
GetHandleFromThread – metoda Mapy ID vlákna na popisovač vlákna Win32.
GetILFunctionBody – metoda Získá ukazatel na tělo metody v kódu CIL (Common Intermediate Language) počínaje jeho hlavičkou.
GetILFunctionBodyAllocator – metoda Získá rozhraní, které poskytuje metodu přidělení paměti, která se má použít pro prohození těla metody v kódu CIL.
GetILToNativeMapping – metoda Získá mapování z posunů CIL na nativní posuny kódu obsaženého v zadané funkci.
GetInprocInspectionInterface – metoda Získá objekt, který lze dotazovat na ICorDebugProcess rozhraní. Tato metoda je zastaralá v rozhraní .NET Framework verze 2.0.
GetInprocInspectionIThisThread – metoda Získá objekt, který lze dotazovat pro ICorDebugThread rozhraní. Tato metoda je zastaralá v rozhraní .NET Framework verze 2.0.
GetModuleInfo – metoda Vzhledem k ID modulu vrátí název souboru modulu a ID nadřazeného sestavení modulu.
GetModuleMetaData – metoda Získá instanci rozhraní metadat, která se mapuje na zadaný modul.
GetObjectSize – metoda Získá velikost zadaného objektu.
GetThreadContext – metoda Získá kontextovou identitu, která je aktuálně přidružená k zadanému vláknu.
GetThreadInfo – metoda Získá aktuální identitu vlákna Win32 pro zadané vlákno.
GetTokenAndMetadataFromFunction – metoda Získá token metadat a instanci rozhraní metadat, které lze použít pro token pro zadanou funkci.
IsArrayClass – metoda Určuje, zda zadaná třída je maticová třída.
SetEnterLeaveFunctionHooks – metoda Určuje funkce implementované profilerem, které se mají volat při volání "enter", "leave" a "tailcall" háky spravovaných funkcí.
SetEventMask – metoda Nastaví hodnotu, která určuje typy událostí, pro které profiler chce přijímat oznámení z MODULU CLR.
SetFunctionIDMapper – metoda Určuje funkci implementovanou profilerem, která bude volána k mapování FunctionID hodnot na alternativní hodnoty, které se předávají do vstupních/výstupních háků funkce profileru.
SetFunctionReJIT – metoda Není implementováno. Nepoužívat.
SetILFunctionBody – metoda Nahradí tělo zadané funkce v zadaném modulu.
SetILInstrumentedCodeMap – metoda Určuje, jak posuny původního mapování CIL zadané funkce na nové posuny objektu CIL změněného profilerem funkce.

Poznámky

Profiler volá metodu v ICorProfilerInfo rozhraní pro komunikaci s CLR za účelem řízení monitorování událostí a vyžádání informací.

Metody ICorProfilerInfo rozhraní jsou implementovány CLR pomocí modelu s volným vláknem. Každá metoda vrátí hodnotu HRESULT, která označuje úspěch nebo selhání. Seznam možných návratových kódů najdete v části CorError.h.

CLR předá prostřednictvím implementace ICorProfilerCallback::InitializeICorProfilerInfo rozhraní pro každý profiler kódu během inicializace. Profiler kódu pak může volat metody ICorProfilerInfo rozhraní, aby získal informace o spravovaném kódu, který se spouští pod kontrolou CLR.

Požadavky

Platformy: Viz požadavky na systém.

Hlavička: CorProf.idl, CorProf.h

Knihovna: CorGuids.lib

Verze rozhraní .NET Framework: Dostupné od verze 2.0

Viz také