Udostępnij za pośrednictwem


FunctionEnter — Funkcja

Powiadamia profilera, że kontrolka jest przekazywana do funkcji.

Uwaga

Funkcja FunctionEnter jest przestarzała w .NET Framework wersji 2.0, a jej użycie spowoduje naliczanie kary za wydajność. Zamiast tego użyj funkcji FunctionEnter2 .

Składnia

void __stdcall FunctionEnter (  
    [in]  FunctionID funcID  
);  

Parametry

funcID [w] Identyfikator funkcji, do której jest przekazywana kontrolka.

Uwagi

Funkcja FunctionEnter jest wywołaniem zwrotnym. Należy ją zaimplementować. Implementacja musi używać atrybutu __declspecklasy magazynu (naked).

Aparat wykonywania nie zapisuje żadnych rejestrów przed wywołaniem tej funkcji.

  • Podczas wprowadzania należy zapisać wszystkie używane rejestry, w tym te w jednostce zmiennoprzecinkowej (FPU).

  • Po wyjściu należy przywrócić stos, wyskakując wszystkie parametry wypchnięte przez jego obiekt wywołujący.

Implementacja nie powinna blokować, FunctionEnter ponieważ opóźni odzyskiwanie pamięci. Implementacja nie powinna próbować odzyskiwania pamięci, ponieważ stos może nie być w stanie przyjaznym dla odzyskiwania pamięci. Jeśli zostanie podjęta próba odzyskiwania pamięci, środowisko uruchomieniowe zostanie zablokowane do momentu FunctionEnter powrotu.

FunctionEnter Ponadto funkcja nie może wywoływać kodu zarządzanego ani w żaden sposób powodować alokację pamięci zarządzanej.

Wymagania

Platformy: Zobacz Wymagania systemowe.

Nagłówka: CorProf.idl

Biblioteki: CorGuids.lib

.NET Framework wersje: 1.1, 1.0

Zobacz też