FunctionTailcall3WithInfo-Funktion

Artikel
08/10/2011

Benachrichtigt den Profiler, dass die gerade ausgeführte Funktion im Begriff ist, einen Endeaufruf einer anderen Funktion auszuführen, und stellt ein Handle bereit, das an die ICorProfilerInfo3::GetFunctionTailcall3Info-Methode übergeben werden kann, um den Stapelframe abzurufen.

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

Parameter

functionIDOrClientID
[in] Der Bezeichner der aktuell ausgeführten Funktion, die im Begriff ist, einen Endeaufruf durchzuführen.
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 FunctionTailcall3WithInfo-Rückrufmethode benachrichtigt den Profiler, wenn Funktionen aufgerufen werden, und ermöglicht es dem Profiler, die ICorProfilerInfo3::GetFunctionTailcall3Info-Methode zu verwenden, um den Stapelrahmen zu überprüfen. Um auf Informationen über Stapelrahmen zuzugreifen, muss das COR_PRF_ENABLE_FRAME_INFO-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 FunctionTailcall3WithInfo-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 FunctionTailcall3WithInfo 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 FunctionTailcall3WithInfo zurückkehrt.

Außerdem darf die FunctionTailcall3WithInfo-Funktion keinen verwalteten Code aufrufen und auf keine Weise verwalteten Speicher belegen.