Fonctions statiques globales du profilage

Cette section décrit les fonctions API non managées utilisées par l’API de profilage.

Dans cette section

Fonctions de profilage .NET Framework version 1

FunctionEnter (fonction)
Avertit le profileur que le contrôle est passé à une fonction. Déconseillé dans .NET Framework 2.0.

FunctionLeave (fonction)
Avertit le profileur qu’une fonction est sur le point de revenir à l’appelant. Déconseillé dans .NET Framework 2.0.

FunctionTailcall (fonction)
Avertit le profileur que la fonction en cours d’exécution est sur le point d’effectuer un appel tail à une autre fonction. Déconseillé dans .NET Framework 2.0.

Fonctions de profilage .NET Framework version 2

FunctionIDMapper (fonction)
Informe le profileur que l’identificateur donné d’une fonction peut être remappé vers un autre ID à utiliser dans les rappels FunctionEnter2, FunctionLeave2 et FunctionTailcall2 pour cette fonction. Permet également au profileur d’indiquer s’il souhaite recevoir des rappels pour cette fonction

FunctionEnter2 (fonction)
Avertit le profileur que le contrôle est passé à une fonction et fournit des informations sur le frame de pile et les arguments de fonction. Déconseillé dans .NET Framework 4.

FunctionLeave2 (fonction)
Avertit le profileur qu’une fonction est sur le point de revenir à l’appelant et fournit des informations sur le frame de pile et la valeur de retour de fonction. Déconseillé dans .NET Framework 4.

FunctionTailcall2 (fonction)
Avertit le profileur que la fonction en cours d’exécution est sur le point d’effectuer un appel tail à une autre fonction et fournit des informations sur le frame de pile. Déconseillé dans .NET Framework 4.

StackSnapshotCallback (fonction)
Fournit au profileur des informations sur chaque cadre managé et chaque exécution de cadres non managés sur la pile pendant une procédure de pile, qui est lancée par la méthode ICorProfilerInfo2::DoStackSnapshot.

Fonctions de profilage .NET Framework version 4

FunctionIDMapper2, fonction
Informe le profileur que l’identificateur donné d’une fonction peut être remappé vers un autre ID à utiliser dans les rappels FunctionEnter3, FunctionLeave3, and FunctionTailcall3, orFunctionEnter3WithInfo, FunctionLeave3WithInfo et FunctionTailcall3WithInfo pour cette fonction. Permet également au profileur d’indiquer s’il souhaite recevoir des rappels pour cette fonction.

FunctionIDMapper2 étend la fonction FunctionIDMapper avec un paramètre clientData, que les profils peuvent utiliser pour lever l’ambiguïté entre les runtimes.

FunctionEnter3, fonction
Avertit le profileur que le contrôle est passé à une fonction.

FunctionEnter3WithInfo, fonction
Notifie le profileur que le contrôle est transmis à une fonction et fournit un descripteur qui peut être passé à ICorProfilerInfo3::GetFunctionEnter3Info pour récupérer le frame de pile et les arguments de fonction.

FunctionLeave3, fonction
Avertit le profileur que le contrôle est retourné à partir d’une fonction.

FunctionLeave3WithInfo, fonction
Notifie le profileur que le contrôle est retourné à partir d’une fonction et fournit un handle qui peut être passé à ICorProfilerInfo3::GetFunctionLeave3Info pour récupérer le frame de pile et la valeur renvoyée.

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

FunctionTailcall3WithInfo, fonction
Avertit le profileur que la fonction en cours d’exécution est sur le point d’effectuer un appel de fin à une autre fonction et fournit un handle qui peut être transmis à ICorProfilerInfo3::GetFunctionTailcall3Info pour récupérer le frame de pile.

Sections connexes

Vue d’ensemble du profilage

Interfaces de profilage

Énumérations de profilage

Structures de profilage