FunctionEnter3WithInfo, fonction

  • Article

Avertit le profileur que le contrôle est passé à une fonction et fournit un handle qui peut être transmis à la méthode ICorProfilerInfo3::GetFunctionEnter3Info pour récupérer les arguments de la trame de pile et de fonction.

Syntaxe

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

Paramètres

functionIDOrClientID [in] Identificateur de la fonction à laquelle le contrôle est passé.

eltInfo [in] Handle opaque qui représente des informations sur un frame de pile donné. Il est valide seulement pendant le rappel auquel il est passé.

Notes

La méthode de rappel FunctionEnter3WithInfo notifie le profileur en tant que fonctions et permet au profileur d’utiliser la méthode ICorProfilerInfo3::GetFunctionEnter3Info pour inspecter les valeurs d’argument. Pour accéder aux informations d’argument, l’indicateur COR_PRF_ENABLE_FUNCTION_ARGS doit être défini. Le profileur peut utiliser la méthode ICorProfilerInfo::SetEventMask pour définir les indicateurs d’événement, puis utiliser la méthode ICorProfilerInfo3::SetEnterLeaveFunctionHooks3WithInfo pour inscrire votre implémentation de cette fonction.

La fonction FunctionEnter3WithInfo 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 FunctionEnter3WithInfo 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 FunctionEnter3WithInfo soit retourné.

La fonction FunctionEnter3WithInfo 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 2.0

Voir aussi