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

FunctionEnter3WithInfo függvény

Értesíti a profilozót, hogy a vezérlő egy függvénynek van átadva, és egy leírót biztosít, amely átadható az ICorProfilerInfo3::GetFunctionEnter3Info metódusnak a veremkeret és a függvényargumentumok lekéréséhez.

Szintaxis

void __stdcall FunctionEnter3WithInfo(  
               [in] FunctionIDOrClientID functionIDOrClientID,  
               [in] COR_PRF_ELT_INFO eltInfo);

Paraméterek

functionIDOrClientID [in] Annak a függvénynek az azonosítója, amelynek a vezérlőt átadják.

eltInfo [in] Egy átlátszatlan fogópont, amely egy adott veremkerettel kapcsolatos információkat jelöl. Ez a leíró csak a visszahívás során érvényes, amelyre át lett adva.

Megjegyzések

A FunctionEnter3WithInfo visszahívási módszer értesíti a profilert függvények meghívásaként, és lehetővé teszi a profilozó számára, hogy az ICorProfilerInfo3::GetFunctionEnter3Info metódust használja az argumentumértékek vizsgálatához. Az argumentumadatok eléréséhez be kell állítani a COR_PRF_ENABLE_FUNCTION_ARGS jelzőt. A profilozó az ICorProfilerInfo::SetEventMask metódussal állíthatja be az eseményjelölőket, majd az ICorProfilerInfo3::SetEnterLeaveFunctionHooks3WithInfo metódussal regisztrálhatja a függvény implementációját.

A FunctionEnter3WithInfo függvény visszahívás; implementálnia kell. Az implementációnak a __declspec(naked) storage-class attribútumot kell használnia.

A végrehajtási motor nem menti a regisztereket a függvény meghívása előtt.

  • A bejegyzéskor mentenie kell az összes használt regisztert, beleértve a lebegőpontos egységben (FPU) lévőket is.

  • Kilépéskor vissza kell állítania a vermet a hívó által leküldett összes paraméter kiugraásával.

A megvalósítása FunctionEnter3WithInfo nem tilthatja le, mert késlelteti a szemétgyűjtést. Az implementáció nem kísérelhet meg szemétgyűjtést, mert előfordulhat, hogy a verem nem szemétgyűjtés-barát állapotban van. Ha szemétgyűjtést kísérel meg, a futtatókörnyezet addig blokkolódik, amíg vissza nem FunctionEnter3WithInfo tér.

A FunctionEnter3WithInfo függvény nem hívhat be felügyelt kódot, és semmilyen módon nem okozhat felügyelt memóriafoglalást.

Követelmények

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

Fejléc: CorProf.idl

Könyvtár: CorGuids.lib

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

Lásd még

  • Last updated on