FunctionIDMapper2, fonction

Article
05/10/2023

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

Syntaxe

UINT_PTR __stdcall FunctionIDMapper2 (  
    [in]  FunctionID  funcId,  
    [in]  void * clientData,  
    [out] BOOL       *pbHookFunction  
);

Paramètres

funcId [in] Identificateur de fonction à remapper.

clientData [in] Pointeur vers les données utilisées pour distinguer les différents runtimes.

pbHookFunction [out] Pointeur vers une valeur à laquelle le profileur affecte true s’il souhaite recevoir des rappels FunctionEnter3, FunctionLeave3 et FunctionTailcall3 ou FunctionEnter3WithInfo, FunctionLeave3WithInfo et FunctionTailcall3WithInfo ; sinon, il affecte false à cette valeur.

Valeur de retour

Le profileur retourne une valeur que le moteur d'exécution utilise comme autre identificateur de fonction. La valeur de retour ne peut pas être null, sauf si false est retourné dans pbHookFunction. Sinon, une valeur de retour null génère des résultats imprévisibles pouvant aller jusqu'à l'arrêt du processus.

Notes

Cette méthode étend la fonction FunctionIDMapper avec un paramètre supplémentaire qui permet de passer des données client. Les données client sont utilisées pour distinguer les différents runtimes.

Spécifications

Plateformes : Consultez Configuration requise.

Header: CorProf.idl

Bibliothèque : CorGuids.lib

Versions de .NET Framework : Disponible depuis la version 4

Partager via