FunctionEnter, fonction

Article
08/22/2008

Mise à jour : novembre 2007

Notifie le profileur que le contrôle est en train d'être passé à une fonction.

Remarque :
La fonction FunctionEnter est désapprouvée dans la version 2.0 du .NET Framework. Elle continuera à fonctionner, mais altérera les performances. Utilisez à la place la fonction FunctionEnter2.

void FunctionEnter (
        [in]  FunctionID funcID
);

Paramètres

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

Notes

La fonction FunctionEnter 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 réinitialisant tous les paramètres qui ont fait l'objet d'un push par son appelant.

L'implémentation du FunctionEnter 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 FunctionEnter soit retourné.

De plus, la fonction FunctionEnter 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.