Поделиться через

Функция FunctionIDMapper2

  • Статья

Уведомляет профилировщика о том, что заданный идентификатор функции может быть переназначен альтернативному идентификатору, который будет использоваться в обратных вызовах FunctionEnter3, FunctionLeave3 и FunctionTailcall3 илиFunctionEnter3WithInfo, FunctionLeave3WithInfo и FunctionTailcall3WithInfo для этой функции. FunctionIDMapper2 также позволяет профилировщику указать, желает ли он получать обратные вызовы для этой функции.

Синтаксис

UINT_PTR __stdcall FunctionIDMapper2 (  
    [in]  FunctionID  funcId,  
    [in]  void * clientData,  
    [out] BOOL       *pbHookFunction  
);

Параметры

funcId [in] Идентификатор функции, который необходимо сопоставить.

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

pbHookFunction [out] Указатель на значение, которое задается true профилировщиком, если он хочет получать FunctionEnter3обратные вызовы , FunctionLeave3и FunctionTailcall3, или FunctionEnter3WithInfo, FunctionLeave3WithInfoи ; в FunctionTailcall3WithInfo противном случае для этого значения устанавливается значение false.

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

Профилировщик возвращает значение, которое использует подсистема выполнения в качестве альтернативного идентификатора функции. Это возвращаемое значение не может быть значением null, если указатель pbHookFunction возвращает значение false. В противном случае возвращаемое значение null приводит к непредсказуемым результатам, включая возможное прерывание процесса.

Комментарии

Этот метод расширяет функцию FunctionIDMapper дополнительным параметром, который используется для передачи данных клиента. Эти данные клиента служат для однозначного определения среды выполнения.

Требования

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

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

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

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

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