ICorProfilerInfo3::SetFunctionIDMapper2 Method

.NET Framework (current version)
 

Specifies the profiler-implemented function that will be called to map FunctionID values to alternative values, which are passed to the profiler's function entry/exit hooks. This method extends the ICorProfilerInfo::SetFunctionIDMapper method with an additional data parameter, which profilers may use to disambiguate among runtimes.

HRESULT SetFunctionIDMapper2(  
       [in] FunctionIDMapper2 *pFunc,  
       [in] void *clientData);  

Parameters

pFunc
[in] A pointer to a FunctionIDMapper2 implementation that will be called to map the FunctionID values to their alternative values.

clientData
[in] A pointer that is passed to every FunctionIDMapper2 function call made by the current runtime. The profiler can use this information to disambiguate among runtimes.

The alternatives for the FunctionID values will be passed to the profiler's function entry/exit hooks (FunctionEnter3, FunctionLeave3, and FunctionTailcall3; or FunctionEnter3WithInfo, FunctionLeave3WithInfo, and FunctionTailcall3WithInfo) that are specified by the SetEnterLeaveFunctionHooks3 or SetEnterLeaveFunctionHooks3WithInfo method.

The FunctionIDMapper2 method can be set only once; we recommend that you set it in the ICorProfilerCallback::Initialize callback.

Platforms: See System Requirements.

Header: CorProf.idl, CorProf.h

Library: CorGuids.lib

.NET Framework Versions: Available since 4

SetFunctionIDMapper
ICorProfilerInfo3 Interface
Profiling Interfaces
Profiling

Show: