Funzione FunctionIDMapper2FunctionIDMapper2 Function

Notifica al profiler che l'identificatore specificato di una funzione può essere rimappato a un ID alternativo da utilizzare per il FunctionEnter3, FunctionLeave3, e FunctionTailcall3, oFunctionEnter3WithInfo, FunctionLeave3WithInfo, e FunctionTailcall3WithInfo i callback per tale funzione.Notifies the profiler that the given identifier of a function may be remapped to an alternative ID to be used in the FunctionEnter3, FunctionLeave3, and FunctionTailcall3, orFunctionEnter3WithInfo, FunctionLeave3WithInfo, and FunctionTailcall3WithInfo callbacks for that function. FunctionIDMapper2 consente inoltre al profiler di indicare se vuole ricevere i callback per tale funzione.FunctionIDMapper2 also enables the profiler to indicate whether it wants to receive callbacks for that function.

SintassiSyntax

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

ParametriParameters

funcId
[in] Identificatore della funzione di cui eseguire nuovamente il mapping.[in] The function identifier to be remapped.

clientData
[in] Un puntatore ai dati usato per distinguere tra runtime.[in] A pointer to data that is used to disambiguate among runtimes.

pbHookFunction
[out] Un puntatore a un valore che il profiler imposta su true se vuole ricevere i callback FunctionEnter3, FunctionLeave3 e FunctionTailcall3 o FunctionEnter3WithInfo, FunctionLeave3WithInfo e FunctionTailcall3WithInfo; in caso contrario imposta questo valore su false.[out] A pointer to a value that the profiler sets to true if it wants to receive FunctionEnter3, FunctionLeave3, and FunctionTailcall3, or FunctionEnter3WithInfo, FunctionLeave3WithInfo, and FunctionTailcall3WithInfo callbacks; otherwise, it sets this value to false.

Valore restituitoReturn Value

Il profiler restituisce un valore che il motore di esecuzione usa come identificatore alternativo della funzione.The profiler returns a value that the execution engine uses as an alternative function identifier. Il valore restituito non può essere null a meno che non sia restituito false in pbHookFunction.The return value cannot be null unless false is returned in pbHookFunction. In caso contrario, un valore restituito null produrrà risultati imprevedibili, compresa la possibilità di un arresto del processo.Otherwise, a null return value produces unpredictable results, including possibly halting the process.

NoteRemarks

Questo metodo estende il FunctionIDMapper funzione con un parametro aggiuntivo che viene utilizzato per passare dati client.This method extends the FunctionIDMapper function with an additional parameter that is used to pass client data. I dati del client vengono usati per distinguere tra runtime.The client data is used to disambiguate among runtimes.

RequisitiRequirements

Piattaforme: vedere requisiti di sistema.Platforms: See System Requirements.

Intestazione: Corprof. idlHeader: CorProf.idl

Libreria: CorGuids. libLibrary: CorGuids.lib

Versioni di .NET framework: Disponibile dalla 4Available since 4.NET Framework Versions: Disponibile dalla 4Available since 4

Vedere ancheSee Also

ICorProfilerInfo:: SetFunctionIDMapperICorProfilerInfo::SetFunctionIDMapper
ICorProfilerInfo3::SetFunctionIDMapper2ICorProfilerInfo3::SetFunctionIDMapper2
FunctionEnter3FunctionEnter3
FunctionLeave3FunctionLeave3
FunctionTailcall3FunctionTailcall3
FunctionEnter3WithInfoFunctionEnter3WithInfo
FunctionLeave3WithInfoFunctionLeave3WithInfo
FunctionTailcall3WithInfoFunctionTailcall3WithInfo
Funzioni statiche globali di profilaturaProfiling Global Static Functions