Funzione FunctionIDMapper2

Articolo
05/10/2023

Notifica al profiler che l'identificatore specificato di una funzione può essere reimpostato in un ID alternativo da usare in FunctionEnter3, FunctionLeave3 e FunctionTailcall3 oFunctionEnter3WithInfo, FunctionLeave3WithInfo e FunctionTailcall3WithInfo. FunctionIDMapper2 consente inoltre al profiler di indicare se vuole ricevere i callback per tale funzione.

Sintassi

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

Parametri

funcId [in] Identificatore di funzione da eseguire nuovamente.

clientData [in] Puntatore ai dati usati per disambiguare tra i runtime.

pbHookFunction[out] Puntatore a un valore impostato dal profiler su true se vuole ricevere FunctionEnter3, FunctionLeave3e , e , e FunctionTailcall3FunctionLeave3WithInfoFunctionEnter3WithInfoFunctionTailcall3WithInfo callback. In caso contrario, imposta questo valore su .false

Valore restituito

Il profiler restituisce un valore che il motore di esecuzione usa come identificatore alternativo della funzione. Il valore restituito non può essere null a meno che non sia restituito false in pbHookFunction. In caso contrario, un valore restituito null produrrà risultati imprevedibili, compresa la possibilità di un arresto del processo.

Commenti

Questo metodo estende la funzione FunctionIDMapper con un parametro aggiuntivo usato per passare i dati client. I dati del client vengono usati per distinguere tra runtime.

Requisiti

Piattaforme: vedere Requisiti di sistema di .NET Framework.

Intestazione: CorProf.idl

Libreria: CorGuids.lib

Versioni di .NET Framework: Disponibile da 4

Condividi tramite