FunctionIDMapper2-Funktion

Artikel
08/10/2011

Benachrichtigt den Profiler, dass der angegebene Bezeichner einer Funktion einer alternativen ID zugeordnet werden kann, um in den Rückrufen FunctionEnter3, FunctionLeave3 und FunctionTailcall3 oderFunctionEnter3WithInfo, FunctionLeave3WithInfo und FunctionTailcall3WithInfo dieser Funktion verwendet zu werden. FunctionIDMapper2 ermöglicht dem Profiler auch anzugeben, ob er Rückrufe für diese Funktion empfangen will.

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 Laufzeiten aufgelöst werden.
pbHookFunction
[out] Ein Zeiger auf einen Wert, den der Profiler auf true festlegt, wenn er die Rückrufe FunctionEnter3, FunctionLeave3, and FunctionTailcall3, orFunctionEnter3WithInfo, FunctionLeave3WithInfo und FunctionTailcall3WithInfo empfangen möchte. Andernfalls wird der Wert auf false festgelegt.

Rückgabewert

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

Hinweise

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