ICorProfilerInfo3::SetFunctionIDMapper2 Method

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.

Remarks

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.

Requirements

Platforms: See .NET Framework System Requirements.

Header: CorProf.idl, CorProf.h

Library: CorGuids.lib

.NET Framework Versions: 4

See Also

Reference

SetFunctionIDMapper

ICorProfilerInfo3 Interface

Other Resources

Profiling Interfaces

Profiling (Unmanaged API Reference)