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

FunctionTailcall3WithInfo függvény

Értesíti a profilozót arról, hogy a jelenleg végrehajtó függvény egy másik függvényre irányuló tail hívást fog végrehajtani, és egy leírót biztosít, amely átadható az ICorProfilerInfo3::GetFunctionTailcall3Info metódusnak a veremkeret lekéréséhez.

Szintaxis

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

Paraméterek

functionIDOrClientID [in] Annak a jelenleg végrehajtó függvénynek az azonosítója, amely a tail hívás indítására készül.

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

Megjegyzések

A FunctionTailcall3WithInfo visszahívási metódus értesíti a profilozót függvények meghívásaként, és lehetővé teszi, hogy a profilozó az ICorProfilerInfo3::GetFunctionTailcall3Info metódust használja a veremkeret vizsgálatához. A veremkeret információinak eléréséhez be kell állítani a COR_PRF_ENABLE_FRAME_INFO jelzőt. A profilkészítő 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 FunctionTailcall3WithInfo 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ó motor nem ment 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 FunctionTailcall3WithInfo 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. Szemétgyűjtési kísérlet esetén a futtatókörnyezet mindaddig blokkolva lesz, amíg vissza nem FunctionTailcall3WithInfo tér.

A FunctionTailcall3WithInfo függvény nem hívhat meg 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 elérhető

Lásd még

  • Last updated on