ICorProfilerInfo3::SetFunctionIDMapper2 Method

Artikkeli
09/15/2021

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.

Syntax

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.

Return Value

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 System Requirements.

Header: CorProf.idl, CorProf.h

Library: CorGuids.lib

.NET Framework Versions: Available since 4

Jaa