FunctionLeave3WithInfo-Funktion

Artikel
08/10/2011

Benachrichtigt den Profiler, dass der Steuerfluss von einer Funktion zurückgegeben wird, und stellt ein Handle bereit, das an die ICorProfilerInfo3::GetFunctionLeave3Info-Methode übergeben werden kann, um den Stapelframe und Rückgabewert abzurufen.

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

Parameter

functionIDOrClientID
[in] Der Bezeichner der Funktion, von der das Steuerelement zurückgegeben wird.
eltInfo
[in] Ein nicht transparentes Handle, das Informationen zu einem angegebenen Stapelrahmen darstellt. Dieses Handle ist nur während des Rückrufs, an den es übergeben wird, gültig.

Hinweise

Die FunctionLeave3WithInfo-Rückrufmethode benachrichtigt den Profiler, wenn Funktionen aufgerufen werden, und ermöglicht es dem Profiler, die ICorProfilerInfo3::GetFunctionLeave3Info-Methode zu verwenden, um den Rückgabewert zu überprüfen. Um auf Informationen über Rückgabewerte zuzugreifen, muss das COR_PRF_ENABLE_FUNCTION_RETVAL-Flag festgelegt werden. Der Profiler kann die Ereignisflags mithilfe der ICorProfilerInfo::SetEventMask-Methode festlegen und verwendet dann die ICorProfilerInfo3::SetEnterLeaveFunctionHooks3WithInfo-Methode, um die Implementierung dieser Funktion zu registrieren.

Die FunctionLeave3WithInfo-Funktion ist ein Rückruf; Sie müssen sie implementieren. Die Implementierung muss das __declspec(naked)-Speicherklassenattribut verwenden.

Das Ausführungsmodul speichert vor dem Aufrufen dieser Funktion keine Register.

Beim Eintritt müssen Sie alle verwendeten Register speichern, auch die Register in der Gleitkommaeinheit (Floating-Point Unit, FPU).
Beim Beenden müssen Sie den Stapel wiederherstellen, indem Sie alle Parameter, die vom Aufrufer verschoben wurden, wieder abholen.

Die Implementierung von FunctionLeave3WithInfo sollte nicht blockieren, da dies die Garbage Collection verzögert. Die Implementierung sollte nicht versuchen, eine Garbage Collection durchzuführen, weil sich der Stapel möglicherweise nicht in einem für die Garbage Collection geeigneten Zustand befindet. Wenn eine Garbage Collection versucht wird, ist die Laufzeit blockiert, bis FunctionLeave3WithInfo zurückkehrt.

Die FunctionLeave3WithInfo-Funktion darf keinen verwalteten Code aufrufen und auf keine Weise verwalteten Speicher belegen.