ICorProfilerInfo3 felület

Olyan módszereket biztosít, amelyekkel a kódprofilozók kommunikálhatnak a közös nyelvi futtatókörnyezettel (CLR) az eseményfigyelés vezérléséhez és az információk lekéréséhez. Az ICorProfilerInfo3 interfész az ICorProfilerInfo2 felület kiterjesztése. A .NET-keretrendszer 4-.NET-keretrendszer újabb verzióiban támogatott új metódusokat biztosít.

Metódusok

Metódus	Leírás
EnumJITedFunctions metódus	Egy enumerátort ad vissza az összes korábban JIT által lefordított függvényhez.
EnumModules metódus	Egy enumerátort ad vissza, amely metódusokat biztosít az alkalmazásba betöltött felügyelt modulok gyűjteményén keresztüli szekvenciális iteráláshoz.
GetAppDomainsContainingModule metódus	Lekéri azon alkalmazástartományok azonosítóit, amelyekbe az adott modul be lett töltve.
GetFunctionEnter3Info metódus	Megadja annak a függvénynek a veremkeretét és argumentumadatait, amelyet a FunctionEnter3WithInfo függvény jelent a profilozónak; csak a FunctionEnter3WithInfo visszahívás során hívható meg.
GetFunctionLeave3Info metódus	Megadja annak a függvénynek a veremkeretét és visszatérési értékét, amelyet a FunctionLeave3WithInfo függvény jelent a profilozónak; csak a FunctionLeave3WithInfo visszahívás során hívható meg.
GetFunctionTailcall3Info metódus	Megadja annak a függvénynek a veremkeretét, amelyet a FunctionTailcall3WithInfo függvény jelent a profilozónak; csak a FunctionTailcall3WithInfo visszahívás során hívható meg.
GetModuleInfo2 metódus	A modulazonosító megadásakor visszaadja a modul fájlnevét, a modul szülőszerelvényének azonosítóját, valamint egy bitmaszkot, amely leírja a modul tulajdonságait.
GetRuntimeInformation metódus	Verzióinformációkat biztosít a profilkészítés alatt álló futtatókörnyezetről.
GetStringLayout2 metódus	Információt kap egy sztringobjektum elrendezéséről.
GetThreadStaticAddress2 metódus	Lekéri a megadott szál-statikus mező címét, amely a megadott szál és alkalmazástartomány hatókörében található.
RequestProfilerDetach metódus	Utasítja a futtatókörnyezetet, hogy válassza le a profilkészítőt.
SetEnterLeaveFunctionHooks3 metódus	Megadja a profilkészítő által implementált függvényeket, amelyek a FunctionEnter3, a FunctionLeave3 és a FunctionTailcall3 függvényen lesznek meghívva.
SetEnterLeaveFunctionHooks3WithInfo metódus	Megadja a profilkészítő által implementált függvényeket, amelyeket a rendszer meghív a felügyelt függvények FunctionEnter3WithInfo, FunctionLeave3WithInfo és FunctionTailcall3WithInfo horogaihoz.
SetFunctionIDMapper2 metódus	Megadja azt a profilkészítő által implementált függvényt, amely az értékek alternatív értékekhez való leképezéséhez FunctionID lesz meghívva, amelyeket a rendszer átad a profilozó függvény belépési/kilépési horgainak. Ez a metódus kiterjeszti az ICorProfilerInfo::SetFunctionIDMapper paramétert, amelyet a profilkészítők a futtatókörnyezetek közötti egyértelműsítésre használhatnak.

Megjegyzések

A CLR implementálja az ICorProfilerInfo3 interfész metódusait a szabadon szálazott 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 fájlban találja.

A CLR az inicializálás során egy felületet ad át ICorProfilerInfo3 az egyes kódprofilelőknek az ICorProfilerCallback::Initialize vagy az ICorProfilerCallback3::InitializeForAttach metódus profilkészítőjének implementálásával. A kódprofilozó ezután meghívhatja a metódusokat, ICorProfilerInfo3 hogy információt kapjon a CLR felügyelete alatt végrehajtott felügyelt kódról.

Követelmények

Platformok: Lásd: Rendszerkövetelmények.

Fejléc: CorProf.idl, CorProf.h

Könyvtár: CorGuids.lib

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

Lásd még

• Profilkészítési felületek
• ICorProfilerInfo felület