Метод ICorProfilerInfo3::SetFunctionIDMapper2

  • Статья

Задает реализуемую профилировщиком функцию, которая будет вызвана для сопоставления значений FunctionID с альтернативными значениями, передаваемыми обработчикам входа и выхода для функции профилировщика. Этот метод расширяет метод ICorProfilerInfo::SetFunctionIDMapper дополнительным параметром данных, который профилировщики могут использовать для устранения неоднозначности между средами выполнения.

Синтаксис

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

Параметры

pFunc
[in] Указатель на реализацию FunctionIDMapper2 , которая будет вызываться для сопоставления значений FunctionID с их альтернативными значениями.

clientData
[in] Указатель, передаваемый в каждый вызов функции FunctionIDMapper2 , выполняемый текущей средой выполнения. Профилировщик может использовать эти сведения для устранения неоднозначности между средами выполнения.

Возвращаемое значение

Комментарии

Альтернативы для значений FunctionID будут передаваться обработчикам входа и выхода из функции профилировщика (FunctionEnter3, FunctionLeave3 и FunctionTailcall3; или FunctionEnter3WithInfo, FunctionLeave3WithInfo и FunctionTailcall3WithInfo), которые задаются методом SetEnterLeaveFunctionHooks3 или SetEnterLeaveFunctionHooks3WithInfo .

Метод FunctionIDMapper2 можно задать только один раз. Рекомендуется задать его в обратном вызове ICorProfilerCallback::Initialize .

Требования

Платформы: см. раздел Требования к системе.

Заголовок: CorProf.idl, CorProf.h

Библиотека: CorGuids.lib

версии платформа .NET Framework: доступно с 4

См. также раздел