ICorProfilerInfo3::SetFunctionIDMapper2-Methode

Gibt die vom Profiler implementierte Funktion an, die aufgerufen wird, um FunctionID-Werte alternativen Werten zuzuordnen, die an die entry/exit-Hooks der Profilerfunktion übergeben werden. Diese Methode erweitert die ICorProfilerInfo::SetFunctionIDMapper-Methode um einen weiteren Datenparameter, mit dem Profiler Mehrdeutigkeiten zwischen Laufzeiten auflösen können.

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

Parameter

• pFunc
  [in] Ein Zeiger auf eine FunctionIDMapper2-Implementierung, die aufgerufen wird, um die FunctionID-Werte alternativen Werten zuzuordnen.

• clientData
  [in] Ein Zeiger, der an jeden von der aktuellen Laufzeit ausgeführten FunctionIDMapper2-Funktionsaufruf übergeben wird. Der Profiler kann mithilfe dieser Informationen Mehrdeutigkeiten zwischen Laufzeiten auflösen.

Hinweise

Die Alternativen für die FunctionID-Werte werden an die Funktionseingangs-/Beendigungshooks des Profilers übergeben (FunctionEnter3, FunctionLeave3 und FunctionTailcall3; oder FunctionEnter3WithInfo, FunctionLeave3WithInfo, und FunctionTailcall3WithInfo), die von der SetEnterLeaveFunctionHooks3-Methode oder der SetEnterLeaveFunctionHooks3WithInfo-Methode angegeben werden.

Die FunctionIDMapper2-Methode kann nur einmal festgelegt werden. Es wird empfohlen, sie im ICorProfilerCallback::Initialize-Rückruf festzulegen.

Anforderungen

Plattformen: siehe Systemanforderungen für .NET Framework.

Header: CorProf.idl, CorProf.h

Bibliothek: CorGuids.lib

.NET Framework-Versionen: 4

Siehe auch

Referenz

SetFunctionIDMapper

ICorProfilerInfo3-Schnittstelle

Weitere Ressourcen

Profilerstellungsschnittstellen

Profilerstellung (Referenz zur nicht verwalteten API)