Udostępnij za pośrednictwem

FunctionIDMapper2 — Funkcja

  • Artykuł

Powiadamia profilera, że dany identyfikator funkcji może zostać ponownie zamapowany na alternatywny identyfikator, który ma być używany w funkcjiEnter3, FunctionLeave3 iFunctionTailcall3 lub FunctionEnter3WithInfo, FunctionLeave3WithInfo i FunctionTailcall3WithInfo wywołania zwrotne dla tej funkcji. FunctionIDMapper2 Umożliwia również profilerowi wskazanie, czy chce odbierać wywołania zwrotne dla tej funkcji.

Składnia

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

Parametry

funcId [w] Identyfikator funkcji, który ma zostać ponownie zamapowany.

clientData [w] Wskaźnik do danych używanych do uściślania środowiska uruchomieniowego.

pbHookFunction[out] Wskaźnik wartości ustawianej przez profilera na true wartość , jeśli chce odbierać FunctionEnter3wartości , FunctionLeave3, i FunctionTailcall3FunctionLeave3WithInfoFunctionEnter3WithInfolub , i FunctionTailcall3WithInfo wywołania zwrotne; w przeciwnym razie ustawia tę wartość na .false

Wartość zwracana

Profiler zwraca wartość używaną przez aparat wykonywania jako identyfikator funkcji alternatywnej. Wartość zwracana nie może być równa null, chyba że false jest zwracana w elemecie pbHookFunction. W przeciwnym razie wartość zwracana o wartości null generuje nieprzewidywalne wyniki, w tym prawdopodobnie zatrzymanie procesu.

Uwagi

Ta metoda rozszerza funkcję FunctionIDMapper z dodatkowym parametrem używanym do przekazywania danych klienta. Dane klienta są używane do uściślania między środowiskami uruchomieniowymi.

Wymagania

Platformy: Zobacz Wymagania systemowe.

Nagłówka: CorProf.idl

Biblioteki: CorGuids.lib

wersje .NET Framework: dostępne od 4

Zobacz też