Partager via

FunctionTailcall (fonction)

  • Article

Avertit le profileur que la fonction en cours d’exécution est sur le point d’effectuer un appel tail à une autre fonction.

Notes

La fonction FunctionTailcall est déconseillée dans .NET Framework 2.0. Elle continuera de fonctionner, mais avec de moins bonnes performances. Utilisez plutôt la fonction FunctionTailcall2.

Syntaxe

void __stdcall FunctionTailcall (  
    [in] FunctionID funcID  
);

Paramètres

funcID [in] Identificateur de la fonction en cours d’exécution qui est sur le point d’effectuer un appel tail.

Notes

La fonction cible de l’appel tail utilise le frame de pile actuel et retourne directement les résultats à l’appelant de la fonction qui a effectué l’appel tail. Cela signifie qu’un rappel FunctionLeave ne sera pas émis pour une fonction qui est la cible d’un appel tail.

La fonction FunctionTailcall 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.

  • 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 FunctionTailcall ne doit pas bloquer, car cela retarderait le garbage collection. L’implémentation ne doit pas tenter un garbage collection, car la pile peut ne pas être dans un état compatible avec le garbage collection. Si un garbage collection est tenté, le runtime bloque jusqu’à ce que FunctionTailcall soit retourné.

En outre, la fonction FunctionTailcall ne doit absolument pas appeler de code managé ni entraîner, de quelque manière, une allocation de mémoire managée.

Spécifications

Plateformes : Consultez Configuration requise.

Header: CorProf.idl

Bibliothèque : CorGuids.lib

Versions de .NET Framework : 1.1, 1.0

Voir aussi