ICorProfilerInfo3::SetEnterLeaveFunctionHooks3WithInfo, méthode

Article
08/10/2011

Spécifie les fonctions implémentées par le profileur qui seront appelées sur les raccordements FunctionEnter3WithInfo, FunctionLeave3WithInfo et FunctionTailcall3WithInfo des fonctions managées.

HRESULT SetEnterLeaveFunctionHooks3WithInfo(
            [in] FunctionEnter3WithInfo    *pFuncEnter3,
            [in] FunctionLeave3withInfo    *pFuncLeave3,
            [in] FunctionTailcall3WithInfo *pFuncTailcall3);

Paramètres

pFuncEnter3
[in] Un pointeur vers l'implémentation à utiliser comme rappel FunctionEnter3WithInfo.
pFuncLeave3
[in] Un pointeur vers l'implémentation à utiliser comme rappel FunctionLeave3WithInfo.
pFuncTailcall3
[in] Un pointeur vers l'implémentation à utiliser comme rappel FunctionTailcall3WithInfo.

Notes

Les raccordements FunctionEnter3WithInfo, FunctionLeave3WithInfo et FunctionTailcall3WithInfo fournissent le frame de pile et l'inspection des arguments. Pour accéder à ces informations, les indicateurs COR_PRF_ENABLE_FUNCTION_ARGS, COR_PRF_ENABLE_FUNCTION_RETVAL, et/ou COR_PRF_ENABLE_FRAME_INFO doivent être définis. Le générateur de profils peut utiliser la méthode ICorProfilerInfo::SetEventMask pour définir les indicateurs d'événement, puis utiliser la méthode SetEnterLeaveFunctionHooks3WithInfo pour enregistrer votre implémentation de cette fonction.

Un seul jeu de rappels peut être actif à la fois, et la version la plus récente est prioritaire. Par conséquent, si un générateur de profils appelle SetEnterLeaveFunctionHooks2 et SetEnterLeaveFunctionHooks3WithInfo, SetEnterLeaveFunctionHooks3WithInfo est utilisé.

La méthode SetEnterLeaveFunctionHooks3WithInfo peut être appelée uniquement à partir du rappel ICorProfilerCallback::Initialize du profileur.