FunctionIDMapper2 – funkce

Článek
05/10/2023

Upozorní profiler, že daný identifikátor funkce může být přemapován na alternativní ID, které se má použít ve zpětných voláních FunctionEnter3, FunctionLeave3 a FunctionTailcall3 neboFunctionEnter3WithInfo, FunctionLeave3WithInfo a FunctionTailcall3WithInfo pro danou funkci. FunctionIDMapper2 umožňuje také profileru určit, jestli chce pro danou funkci přijímat zpětná volání.

Syntaxe

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

Parametry

funcId [v] Identifikátor funkce, který se má přemapovat.

clientData [v] Ukazatel na data, která slouží k nejednoznačnosti mezi moduly runtime.

pbHookFunction [out] Ukazatel na hodnotu, na true kterou profiler nastaví, pokud chce přijímat FunctionEnter3zpětná volání , FunctionLeave3a FunctionTailcall3, nebo FunctionEnter3WithInfo, FunctionLeave3WithInfoa FunctionTailcall3WithInfo . V opačném případě nastaví tuto hodnotu na false.

Návratová hodnota

Profiler vrátí hodnotu, kterou spouštěcí modul používá jako alternativní identifikátor funkce. Vrácená hodnota nemůže být null, pokud false není vrácena v pbHookFunctionsouboru . Jinak vrácená hodnota null vede k nepředvídatelným výsledkům, včetně možného zastavení procesu.

Poznámky

Tato metoda rozšiřuje funkci FunctionIDMapper o další parametr, který se používá k předávání dat klienta. Data klienta slouží k nejednoznačnosti mezi moduly runtime.

Požadavky

Platformy: Viz Požadavky na systém.

Záhlaví: CorProf.idl

Knihovny: CorGuids.lib

Verze rozhraní .NET Framework: K dispozici od 4

Sdílet prostřednictvím