FunctionIDMapper2 函数
通知探查器某个函数的给定标识符可能已重新映射到要在该函数的 FunctionEnter3、FunctionLeave3 和 FunctionTailcall3 回调或 FunctionEnter3WithInfo、FunctionLeave3WithInfo 和 FunctionTailcall3WithInfo 回调中使用的备选 ID。 FunctionIDMapper2 还使探查器可以指示是否需要为该函数接收回调。
UINT_PTR __stdcall FunctionIDMapper2 (
[in] FunctionID funcId,
[in] void * clientData,
[out] BOOL *pbHookFunction
);
参数
funcId
[in] 要重新映射的函数标识符。clientData
[in] 一个指向用于消除运行时之间的歧义的数据的指针。pbHookFunction
[out] 一个指向值的指针,探查器在想要接收 FunctionEnter3、FunctionLeave3 和 FunctionTailcall3 或回调FunctionEnter3WithInfo、FunctionLeave3WithInfo 和 FunctionTailcall3WithInfo 时将该值设置为 true;否则,探查器会将此值设置为 false。
返回值
探查器返回一个值,执行引擎使用该值作为备选函数标识符。 返回值不能为 null,除非 pbHookFunction 中返回了 false。 否则,null 返回值将产生不可预知的结果,包括可能会使进程停止这样的结果。
备注
此方法使用一个用于传递客户端数据的附加函数对 FunctionIDMapper 函数 函数进行了扩展。 客户端数据用于消除运行时之间的歧义。
要求
**平台:**请参见 .NET Framework 系统要求。
**头文件:**CorProf.idl
**库:**CorGuids.lib
**.NET Framework 版本:**4
请参见
参考
ICorProfilerInfo::SetFunctionIDMapper
ICorProfilerInfo3::SetFunctionIDMapper2