Funzione FunctionEnter3WithInfo

Articolo
08/11/2011

Notifica al profiler che il controllo viene passato a una funzione e fornisce un handle che può essere passato al metodo ICorProfilerInfo3::GetFunctionEnter3Info per recuperare lo stack frame e gli argomenti della funzione.

void __stdcall FunctionEnter3WithInfo(
               [in] FunctionIDOrClientID functionIDOrClientID,
               [in] COR_PRF_ELT_INFO eltInfo);

Parametri

functionIDOrClientID
[in] Identificatore della funzione al quale è passato il controllo.
eltInfo
[in] Handle opaco che rappresenta le informazioni su uno stack frame specificato. Questo handle è valido solo durante il callback a cui viene passato.

Note

Il metodo di callback FunctionEnter3WithInfo notifica al profiler le funzioni che vengono chiamate e consente al profiler di esaminare i valori degli argomenti tramite il metodo ICorProfilerInfo3::GetFunctionEnter3Info. Per accedere alle informazioni degli argomenti deve essere impostato il flag COR_PRF_ENABLE_FUNCTION_ARGS. Il profiler può utilizzare prima il metodo ICorProfilerInfo::SetEventMask per impostare i flag dell'evento e quindi il metodo ICorProfilerInfo3::SetEnterLeaveFunctionHooks3WithInfo per registrare l'implementazione di questa funzione.

La funzione FunctionEnter3WithInfo è un callback; è necessario implementarla. L'implementazione deve utilizzare l'attributo della classe di archiviazione __declspec(naked).

Il motore di esecuzione non salva alcun registro prima di chiamare la funzione.

In ingresso, è necessario salvare tutti i registri che si utilizzano, incluso quelli dell'unità a virgola mobile (FPU).
In uscita, è necessario ripristinare lo stack recuperando tutti i parametri inseriti dal chiamante.

L'implementazione di FunctionEnter3WithInfo non deve bloccarsi perché rimanderà l'operazione di Garbage Collection. L'implementazione non deve tentare una Garbage Collection perché lo stack potrebbe non trovarsi in uno stato favorevole per tale operazione. Se viene tentato un Garbage Collection, il runtime si bloccherà fino al completamento di FunctionEnter3WithInfo.

La funzione FunctionEnter3WithInfo non deve effettuare una chiamata nel codice gestito o causare in alcun modo un'allocazione della memoria gestita.