Funzione FunctionLeave

Articolo
08/11/2011

Notifica al profiler che una funzione sta per ritornare al chiamante.

Nota
La funzione FunctionLeave è deprecata in .NET Framework 2.0.Tale funzione continuerà a funzionare, ma con una riduzione delle prestazioni.Utilizzare, invece, la funzione FunctionLeave2.

void __stdcall FunctionLeave (
    [in] FunctionID funcID
);

Parametri

funcID
[in] Identificatore della funzione in corso di completamento.

Note

La funzione FunctionLeave è 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 FunctionLeave 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 FunctionLeave.

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