FunctionIDMapper2 (Función)

Artículo
08/10/2011

Notifica al generador de perfiles que el identificador especificado de una función puede reasignarse a otro identificador que se va a usar en las devoluciones de llamada FunctionEnter3, FunctionLeave3 y FunctionTailcall3 o las devoluciones de llamada FunctionEnter3WithInfo, FunctionLeave3WithInfo y FunctionTailcall3WithInfo de esa función. FunctionIDMapper2 también permite al generador de perfiles indicar si se desea recibir devoluciones de llamada para esa función.

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

Parámetros

funcId
[in] Identificador de la función que se va a reasignar.
clientData
[in] Puntero a datos que se usa para eliminar la ambigüedad entre los runtime.
pbHookFunction
[out] Puntero a un valor que el generador de perfiles establece en true si desea recibir devoluciones de llamada FunctionEnter3, FunctionLeave3 y FunctionTailcall3, oFunctionEnter3WithInfo, FunctionLeave3WithInfo y FunctionTailcall3WithInfo; de lo contrario, establece este valor en false.

Valor devuelto

El generador de perfiles devuelve un valor que el motor de ejecución utiliza como identificador de función alternativo. El valor devuelto no puede ser null a menos que se devuelva false en pbHookFunction. De lo contrario, la devolución de un valor nulo genera resultados imprevisibles, que posiblemente incluyan la detención del proceso.

Comentarios

Este método extiende la función FunctionIDMapper (Función) con un parámetro adicional que se usa para pasar datos del cliente. Los datos del cliente se usan para eliminar la ambigüedad entre los runtime.