ICorProfilerInfo – rozhraní
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á zobjektu, 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
