Funzione FunctionEnter

Articolo
08/11/2011

Notifica al profiler che il controllo è passato a una funzione.

Nota
La funzione FunctionEnter è obsoleta in .NET Framework versione 2.0 e il suo utilizzo comporta una riduzione delle prestazioni.Utilizzare la funzione FunctionEnter2.

void __stdcall FunctionEnter (
    [in]  FunctionID funcID
);

Parametri

funcID
[in] Identificatore della funzione al quale è passato il controllo.

Note

La funzione FunctionEnter è un callback; è necessario implementarla. L'implementazione deve utilizzare l'attributo del 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 FunctionEnter non deve bloccarsi perché ritarderà il 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 FunctionEnter.

Inoltre, la funzione FunctionEnter non deve effettuare una chiamata nel codice gestito o causare in alcun modo un'allocazione della memoria gestita.