FunctionIDMapper2-Funktion

Artikel
06/02/2023

Benachrichtigt den Profiler, dass der angegebene Bezeichner einer Funktion einer alternativen ID zugeordnet werden kann, um in den Rückrufen FunctionEnter3, FunctionLeave3 und FunctionTailcall3 oder FunctionEnter3WithInfo, FunctionLeave3WithInfo und FunctionTailcall3WithInfo dieser Funktion verwendet zu werden. Mit FunctionIDMapper2kann der Profiler auch angeben, ob er Rückrufe für diese Funktion empfangen will.

Syntax

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

Parameter

funcId [in] Der Funktionsbezeichner, der neu zugeordnet werden soll.

clientData [in] Ein Zeiger auf Daten, mit denen Mehrdeutigkeiten zwischen Runtimes aufgelöst werden.

pbHookFunction [out] Ein Zeiger auf einen Wert, den der Profiler auf true festlegt, wenn er die Rückrufe FunctionEnter3, FunctionLeave3 und FunctionTailcall3 oder FunctionEnter3WithInfo, FunctionLeave3WithInfo und FunctionTailcall3WithInfo empfangen möchte. Andernfalls wird der Wert auf false festgelegt.

Rückgabewert

Der Profiler gibt einen Wert zurück, den die Ausführungs-Engine als alternativen Funktionsbezeichner verwendet. Der Rückgabewert darf nicht NULL sein, es sei denn, in false wird pbHookFunction zurückgegeben. Andernfalls führt ein Rückgabewert von NULL zu unvorhersehbaren Ergebnissen, einschließlich des möglichen Anhaltens des Prozesses.

Bemerkungen

Diese Methode erweitert die FunctionIDMapper-Funktion um einen zusätzlichen Parameter, der zum Übergeben von Clientdaten verwendet wird. Die Clientdaten werden verwendet, um Mehrdeutigkeiten zwischen Laufzeiten aufzulösen.

Anforderungen

Plattformen: Informationen finden Sie unter Systemanforderungen.

Header: CorProf.idl

Bibliothek: CorGuids.lib

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

Freigeben über