FunctionIDMapper2, fonction

Article
08/10/2011

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 ou FunctionTailcall3WithInfo pour cette fonction. FunctionIDMapper2 permet également au profileur d'indiquer s'il souhaite recevoir des rappels pour cette fonction.

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

Paramètres

funcId
[in] Identificateur de la fonction à remapper.
clientData
[in] Pointeur vers les données permettant de lever l'ambiguïté au niveau des runtimes.
pbHookFunction
[out] Pointeur vers une valeur à laquelle le profileur affecte true s'il souhaite recevoir des rappels FunctionEnter3, FunctionLeave3 et FunctionTailcall3 ou FunctionEnter3WithInfoFunctionLeave3WithInfo et FunctionTailcall3WithInfo ; sinon, il affecte à cette valeur false.

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èrera des résultats imprévisibles, pouvant aller jusqu'à l'arrêt du processus.

Notes

Cette méthode étend la fonction FunctionIDMapper (fonction) avec un paramètre supplémentaire utilisé pour passer des données client. Les données client sont utilisées pour lever l'ambiguïté au niveau des runtimes.