Megosztás a következőn keresztül:


ICorProfilerInfo felület

Metódusokat biztosít a kódprofilozók számára a közös nyelvi futtatókörnyezettel (CLR) való kommunikációhoz az eseményfigyelés és az információk lekérése céljából.

Feljegyzés

Az interfész minden metódusa ICorProfilerInfo egy HRESULT értéket ad vissza, amely jelzi a sikert vagy a hibát. A lehetséges visszatérési kódok listáját a CorError.h webhelyen találja.

Metódusok

Metódus Leírás
BeginInprocDebugging metódus Inicializálja a folyamatban lévő hibakeresési támogatást. Ez a módszer elavult .NET-keretrendszer 2.0-s verziójában.
EndInprocDebugging metódus Leállítja a folyamatban lévő hibakeresési munkamenetet. Ez a módszer elavult .NET-keretrendszer 2.0-s verziójában.
ForceGC metódus Arra kényszeríti a szemétgyűjtést, hogy a futásidőben történjen.
GetAppDomainInfo metódus Információt kér le a megadott alkalmazástartományról.
GetAssemblyInfo metódus Információt kap a megadott szerelvényről.
GetClassFromObject metódus Lekéri a ClassID

objektum, tekintettel annak ObjectID.
GetClassFromToken metódus Lekéri az osztály azonosítóját a metaadat-jogkivonat alapján. Ez a módszer elavult .NET-keretrendszer 2.0-s verziójában. Használja inkább az ICorProfilerInfo2::GetClassFromTokenAndTypeArgs metódust.
GetClassIDInfo metódus Lekéri a szülőmodult és a megadott osztály metaadat-jogkivonatát.
GetCodeInfo metódus Lekéri a megadott függvényazonosítóhoz társított natív kód mértékét. Ez a módszer elavult. Használja inkább az ICorProfilerInfo2::GetCodeInfo2 metódust.
GetCurrentThreadID metódus Lekéri az aktuális szál azonosítóját, ha felügyelt szálról van szó.
GetEventMask metódus Lekéri azokat az aktuális eseménykategóriákat, amelyekről a profilkészítő eseményértesítéseket szeretne kapni a CLR-től.
GetFunctionFromIP metódus Térképek egy felügyelt kód utasításmutatóját egy FunctionID.
GetFunctionFromToken metódus Lekéri egy függvény azonosítóját. Ez a módszer elavult .NET-keretrendszer 2.0-s verziójában. Használja inkább az ICorProfilerInfo2::GetFunctionFromTokenAndTypeArgs metódust.
GetFunctionInfo metódus Lekéri a megadott függvény szülőosztályát és metaadat-jogkivonatát.
GetHandleFromThread metódus Térképek egy szál azonosítóját egy Win32-szálfogópontra.
GetILFunctionBody metódus A metódus törzsére mutató mutatót kap a közös köztes nyelvű (CIL) kódban, a fejlécétől kezdve.
GetILFunctionBodyAllocator metódus Lekéri a CIL-kódban lévő metódus törzsének felcseréléséhez használandó memória lefoglalására szolgáló felületet.
GetILToNativeMapping metódus Lekéri a térképet a CIL-eltolásoktól a megadott függvényben található kód natív eltolásaiig.
GetInprocInspectionInterface metódus Lekérdezhető objektumot kér le egy ICorDebugProcess-felülethez. Ez a módszer elavult .NET-keretrendszer 2.0-s verziójában.
GetInprocInspectionIThisThread metódus Lekérdezhető objektumot kap az ICorDebugThread felülethez. Ez a módszer elavult .NET-keretrendszer 2.0-s verziójában.
GetModuleInfo metódus A modulazonosítót megadva visszaadja a modul fájlnevét és a modul szülőszerelvényének azonosítóját.
GetModuleMetaData metódus Lekéri a megadott modulhoz leképezve lévő metaadat-felületpéldányt.
GetObjectSize metódus Lekéri egy adott objektum méretét.
GetThreadContext metódus Lekéri a megadott szálhoz jelenleg társított környezeti identitást.
GetThreadInfo metódus Lekéri a megadott szál aktuális Win32-szálidentitását.
GetTokenAndMetadataFromFunction metódus Lekéri a metaadat-jogkivonatot és a metaadat-felület egy példányát, amely a megadott függvény jogkivonatához használható.
IsArrayClass metódus Meghatározza, hogy a megadott osztály tömbosztály-e.
SetEnterLeaveFunctionHooks metódus Meghatározza a profilkészítő által implementált függvényeket, amelyeket a felügyelt függvények "enter", "leave" és "tailcall" horogaihoz kell meghívni.
SetEventMask metódus Beállít egy értéket, amely meghatározza azokat az eseményeket, amelyekről a profilozó értesítést szeretne kapni a CLR-től.
SetFunctionIDMapper metódus Megadja a profilozó által implementált függvényt, amely az értékek alternatív értékekre való leképezésére FunctionID lesz meghívva, amelyeket a rendszer átad a profilozó függvény belépési/kilépési horgainak.
SetFunctionReJIT metódus Nincs implementálva. Ne használja.
SetILFunctionBody metódus A megadott függvény törzsét cseréli le a megadott modulban.
SetILInstrumentedCodeMap metódus Meghatározza, hogy egy adott függvény eredeti CIL-leképezésének eltolásai hogyan felelnek meg a függvény profilkészítővel módosított CIL-jének új eltolásainak.

Megjegyzések

A profilkészítő meghív egy metódust az interfészen, ICorProfilerInfo hogy kommunikáljon a CLR-vel az eseményfigyelés szabályozásához és az információk lekéréséhez.

Az interfész módszereit a ICorProfilerInfo CLR implementálja a szabadszálú modell használatával. Minden metódus egy HRESULT értéket ad vissza, amely jelzi a sikert vagy a hibát. A lehetséges visszatérési kódok listáját a CorError.h webhelyen találja.

A CLR az ICorProfilerCallback::InitializeICorProfilerInfo implementációján keresztül átadja az egyes kódprofilelők felületét az inicializálás során. A kódprofilozó ezután meghívhatja a felület metódusait, ICorProfilerInfo hogy információt kapjon a clr felügyelete alatt végrehajtott felügyelt kódról.

Követelmények

Platformok: Lásd a rendszerkövetelményeket.

Fejléc: CorProf.idl, CorProf.h

Könyvtár: CorGuids.lib

.NET-keretrendszer verziók: 2.0 óta elérhető

Lásd még