StackSnapshotCallback függvény

Az ICorProfilerInfo2::D oStackSnapshot metódus által kezdeményezett, a veremen lévő egyes felügyelt keretekkel és nem felügyelt keretek futtatásával kapcsolatos információkat biztosít a profilozónak.

Szintaxis

HRESULT __stdcall StackSnapshotCallback (  
    [in] FunctionID funcId,  
    [in] UINT_PTR ip,  
    [in] COR_PRF_FRAME_INFO frameInfo,  
    [in] ULONG32 contextSize,  
    [in] BYTE context[],  
    [in] void *clientData  
);

Paraméterek

funcId
[in] Ha ez az érték nulla, akkor ez a visszahívás nem felügyelt keretek futtatására használható; ellenkező esetben ez egy felügyelt függvény azonosítója, és ez a visszahívás felügyelt kerethez tartozik.

ip
[in] A keret natív kódutasítási mutatójának értéke.

frameInfo
[in] A COR_PRF_FRAME_INFO veremkerettel kapcsolatos információkra hivatkozó érték. Ez az érték csak a visszahívás során használható.

contextSize
[in] A struktúra mérete CONTEXT , amelyre a context paraméter hivatkozik.

context
[in] Mutató egy Win32-struktúra CONTEXT felé, amely a keret processzorállapotát jelöli.

A context paraméter csak akkor érvényes, ha a COR_PRF_SNAPSHOT_CONTEXT jelző át lett adva a fájlban ICorProfilerInfo2::DoStackSnapshot.

clientData
[in] Az ügyféladatokra mutató mutató, amely közvetlenül a következőből ICorProfilerInfo2::DoStackSnapshothalad át: .

Megjegyzések

A StackSnapshotCallback függvényt a profilkészítő írója implementálja. Korlátoznia kell a alkalmazásban végzett StackSnapshotCallbackmunka összetettségét. Ha például aszinkron módon használja ICorProfilerInfo2::DoStackSnapshot , előfordulhat, hogy a célszál zárolásokat tart. Ha a kódon belül StackSnapshotCallback ugyanazokra a zárolásokra van szükség, holtpont is létrejönhet.

A ICorProfilerInfo2::DoStackSnapshot metódus felügyelt keretenként egyszer vagy futtatásonként egyszer hívja meg a StackSnapshotCallback függvényt. Ha StackSnapshotCallback nem felügyelt keretek futtatására van meghívva, a profilkészítő a regiszterkörnyezetet (a context paraméter által hivatkozott) használhatja a saját nem felügyelt verem-séta végrehajtásához. Ebben az esetben a Win32-struktúra CONTEXT a legutóbb leküldéses keret processzorállapotát jelöli a nem felügyelt keretek futtatása során. Bár a Win32-struktúra CONTEXT minden regiszterhez tartalmaz értékeket, csak a veremmutató-regiszter, a keretmutató-regiszter, az utasításmutató-regiszter és a nemvolatile (azaz megőrzött) egész számregisztrálók értékeire kell támaszkodnia.

Követelmények

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

Fejléc: CorProf.idl

Könyvtár: CorGuids.lib

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

Lásd még

  • Last updated on