Funzione FunctionEnter2FunctionEnter2 Function

Notifica al profiler che controllo viene passato a una funzione e fornisce informazioni sullo stack di frame e funzione gli argomenti.Notifies the profiler that control is being passed to a function and provides information about the stack frame and function arguments. Questa funzione sostituisce la FunctionEnter (funzione).This function supersedes the FunctionEnter function.

SintassiSyntax

void __stdcall FunctionEnter2 (  
    [in]  FunctionID                       funcId,   
    [in]  UINT_PTR                         clientData,   
    [in]  COR_PRF_FRAME_INFO               func,   
    [in]  COR_PRF_FUNCTION_ARGUMENT_INFO  *argumentInfo  
);  

ParametriParameters

funcId
[in] Identificatore della funzione a cui il controllo viene passato.[in] The identifier of the function to which control is passed.

clientData
[in] Identificatore della funzione modificato, il profiler può essere specificata in precedenza tramite il FunctionIDMapper (funzione).[in] The remapped function identifier, which the profiler previously specified by using the FunctionIDMapper function.

func
[in] Oggetto COR_PRF_FRAME_INFO che punta alle informazioni sullo stack frame.[in] A COR_PRF_FRAME_INFO value that points to information about the stack frame.

Il profiler deve trattare come handle opaco che può essere passato al motore di esecuzione di ICorProfilerInfo2:: Getfunctioninfo2 metodo.The profiler should treat this as an opaque handle that can be passed back to the execution engine in the ICorProfilerInfo2::GetFunctionInfo2 method.

argumentInfo
[in] Un puntatore a un COR_PRF_FUNCTION_ARGUMENT_INFO struttura che specifica le posizioni in memoria degli argomenti della funzione.[in] A pointer to a COR_PRF_FUNCTION_ARGUMENT_INFO structure that specifies the locations in memory of the function's arguments.

Per accedere alle informazioni degli argomenti di COR_PRF_ENABLE_FUNCTION_ARGS flag deve essere impostato.In order to access argument information, the COR_PRF_ENABLE_FUNCTION_ARGS flag must be set. Il profiler può utilizzare il ICorProfilerInfo:: SetEventMask per impostare i flag dell'evento.The profiler can use the ICorProfilerInfo::SetEventMask method to set the event flags.

NoteRemarks

I valori del func e argumentInfo parametri non sono validi dopo il FunctionEnter2 funzione perché i valori potrebbero cambiare o essere distrutti.The values of the func and argumentInfo parameters are not valid after the FunctionEnter2 function returns because the values may change or be destroyed.

Il FunctionEnter2 funzione è un callback, è necessario implementarla.The FunctionEnter2 function is a callback; you must implement it. L'implementazione deve utilizzare il __declspec(naked) attributo della classe di archiviazione.The implementation must use the __declspec(naked) storage-class attribute.

Il motore di esecuzione non viene salvato alcun registro prima di chiamare questa funzione.The execution engine does not save any registers before calling this function.

  • In ingresso, è necessario salvare tutti i registri in uso, inclusi quelli in unità a virgola mobile (FPU).On entry, you must save all registers that you use, including those in the floating-point unit (FPU).

  • All'uscita, è necessario ripristinare lo stack recuperando tutti i parametri che sono stati inviati dal chiamante.On exit, you must restore the stack by popping off all the parameters that were pushed by its caller.

L'implementazione di FunctionEnter2 non devono bloccarsi perché ritarderà l'operazione di garbage collection.The implementation of FunctionEnter2 should not block because it will delay garbage collection. L'implementazione non deve tentare una garbage collection perché lo stack potrebbe non essere in uno stato di raccolta semplice garbage.The implementation should not attempt a garbage collection because the stack may not be in a garbage collection-friendly state. Se si tenta un'operazione di garbage collection, il runtime si bloccherà finché FunctionEnter2 restituisce.If a garbage collection is attempted, the runtime will block until FunctionEnter2 returns.

Inoltre, il FunctionEnter2 funzione non deve chiamare codice gestito o causare in alcun modo un'allocazione di memoria gestita.Also, the FunctionEnter2 function must not call into managed code or in any way cause a managed memory allocation.

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 2.0Available since 2.0.NET Framework Versions: Disponibile dalla 2.0Available since 2.0

Vedere ancheSee Also

Funzione FunctionLeave2FunctionLeave2 Function
Funzione FunctionTailcall2FunctionTailcall2 Function
Metodo SetEnterLeaveFunctionHooks2SetEnterLeaveFunctionHooks2 Method
Funzioni statiche globali di profilaturaProfiling Global Static Functions