FunctionLeave2 函数

  • 项目

通知探查器某个函数将要返回给调用方，并提供有关堆栈帧和函数返回值的信息。

语法

void __stdcall FunctionLeave2 (  
    [in]  FunctionID                        funcId,  
    [in]  UINT_PTR                          clientData,  
    [in]  COR_PRF_FRAME_INFO                func,  
    [in]  COR_PRF_FUNCTION_ARGUMENT_RANGE  *retvalRange  
);

参数

funcId [in] 正在返回的函数的标识符。

clientData [in] 重新映射的函数标识符，该标识符是探查器之前通过 FunctionIDMapper 函数指定的。

func [in] 一个 COR_PRF_FRAME_INFO 值，该值指向有关堆栈帧的信息。

探查器应将此视为可传递回 ICorProfilerInfo2::GetFunctionInfo2 方法中的执行引擎的不透明句柄。

retvalRange [in] 指向 COR_PRF_FUNCTION_ARGUMENT_RANGE 结构的指针，该结构指定函数的返回值的内存位置。

若要访问返回值信息，必须设置 COR_PRF_ENABLE_FUNCTION_RETVAL 标志。 探查器可以使用 ICorProfilerInfo::SetEventMask 方法来设置事件标志。

注解

在 FunctionLeave2 函数返回后 func 和 retvalRange 参数的值无效，因为值可能会更改或被破坏。

FunctionLeave2 函数是一个回调；必须实现它。 实现必须使用 __declspec(naked) 存储类属性。

在调用此函数之前，执行引擎不会保存任何寄存器。

  • 进入时，你需要保存你使用的所有寄存器，包括浮点单元 (FPU) 中的那些寄存器。

  • 退出时，你需要还原堆栈，方法是通过弹出由其调用方推送的所有参数。

FunctionLeave2 的实现不应被阻止，因为它将延迟垃圾回收。 实现不应尝试垃圾回收，因为堆栈可能不处于对垃圾回收有利的状态。 如果尝试了垃圾回收，运行时将被阻止，直到 FunctionLeave2 返回。

此外，FunctionLeave2 函数不得调入托管代码，也不得以任何方式导致托管内存分配。

要求

平台：请参阅系统要求。

标头：CorProf.idl

库：CorGuids.lib

.NET Framework 版本：自 2.0 起可用

另请参阅