FunctionTailcall3WithInfo, fonction

Article
08/10/2011

Notifie le profileur que la fonction s'exécutant actuellement va exécuter un appel tail à une autre fonction et fournit un handle qui peut être passé à la méthode ICorProfilerInfo3::GetFunctionTailcall3Info pour extraire le frame de pile.

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

Paramètres

functionIDOrClientID
[in] Identificateur de la fonction en cours d'exécution qui va faire un appel tail.
eltInfo
[in] Handle opaque qui représente des informations sur un frame de pile donné. Ce handle est valide uniquement pendant le rappel auquel il est passé.

Notes

La méthode de rappel FunctionTailcall3WithInfo notifie le générateur de profils lorsque les fonctions sont appelées, et permet au générateur de profils d'utiliser la méthode ICorProfilerInfo3::GetFunctionTailcall3Info pour inspecter la frame de pile. Pour accéder aux informations de frame de pile, l'indicateur COR_PRF_ENABLE_FRAME_INFO doit être défini. 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 ICorProfilerInfo3::SetEnterLeaveFunctionHooks3WithInfo pour enregistrer votre implémentation de cette fonction.

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

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

À l'entrée, vous devez enregistrer tous les registres que vous utilisez, y compris ceux de l'unité en virgule flottante.
À la sortie, vous devez restaurer la pile en dépilant tous les paramètres qui ont fait l'objet d'un push par son appelant.

L'implémentation de FunctionTailcall3WithInfo ne doit pas bloquer, car cela diffèrerait le garbage collection. L'implémentation ne doit pas tenter de garbage collection, car la pile n'est peut-être pas dans un état de garbage collection convivial. En cas de tentative de garbage collection, le runtime procède à un blocage jusqu'à ce que FunctionTailcall3WithInfo soit retourné.

De plus, la fonction FunctionTailcall3WithInfo ne doit pas effectuer d'appels dans du code managé, ni générer de quelque manière que ce soit une allocation de mémoire managée.