ICorProfilerInfo3::SetFunctionIDMapper2-Methode

Artikel
06/02/2023

Gibt die vom Profiler implementierte Funktion an, die aufgerufen wird, um die FunctionID-Werte alternativen Werten zuzuordnen, die an die Funktionseinstiegs-/-exithooks des Profilers übergeben werden. Diese Methode erweitert die ICorProfilerInfo::SetFunctionIDMapper-Methode um einen zusätzlichen Datenparameter, den Profiler verwenden können, um die einzelnen Runtimes eindeutig zu machen.

Syntax

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

Parameter

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

clientData
[in] Ein Zeiger, der an jeden Aufruf der FunctionIDMapper2-Funktion übergeben wird, der von der aktuellen Runtime ausgeführt wird. Der Profiler kann diese Informationen verwenden, um einzelne Runtimes eindeutig zu machen.

Rückgabewert

Bemerkungen

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

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

Anforderungen

Plattformen: Informationen finden Sie unter Systemanforderungen.

Header: CorProf.idl, CorProf.h

Bibliothek: CorGuids.lib

.NET Framework-Versionen: seit Version 4 verfügbar

Teilen über