Partager via

FunctionLeave3, fonction

  • Article

Notifie le profileur que le contrôle est retourné à partir d’une fonction.

Syntaxe

void __stdcall FunctionLeave3(FunctionOrRemappedID functionOrRemappedID);

Paramètres

functionOrRemappedID [in] Identificateur de la fonction à partir de laquelle le contrôle est retourné.

Notes

La fonction de rappel FunctionLeave3 notifie le profileur au fur et à mesure que des fonctions appelées, mais elle ne prend pas en charge l’inspection des valeurs renvoyées. Utilisez la méthode ICorProfilerInfo3::SetEnterLeaveFunctionHooks3 pour inscrire votre implémentation de cette fonction.

La fonction FunctionLeave3 est un rappel ; vous devez l’implémenter. L’implémentation doit utiliser l’attribut __declspec(naked) de classe de stockage.

Le moteur d’exécution n’enregistre aucun registre avant d’appeler cette fonction.

  • Lors de l’entrée, vous devez enregistrer tous les registres que vous utilisez, y compris ceux de l’unité à virgule flottante (FPU).

  • Lors de la sortie, vous devez restaurer la pile en décochant tous les paramètres qui ont été envoyés par son appelant.

L’implémentation de FunctionLeave3 ne doit pas bloquer, car elle retardera le nettoyage de la mémoire. L’implémentation ne doit pas tenter un nettoyage de la mémoire, car la pile peut ne pas être dans un état convivial de nettoyage de la mémoire. Si un garbage collection est tenté, le runtime bloque jusqu’à ce que FunctionLeave3 soit retourné.

La fonction FunctionLeave3 ne doit absolument pas appeler de code managé ni entraîner une allocation de mémoire managée.

Spécifications

Plateformes : Consultez Configuration requise.

Header: CorProf.idl

Bibliothèque : CorGuids.lib

Versions de .NET Framework : Disponible depuis la version 4

Voir aussi