通过

ICorProfilerInfo3::GetFunctionEnter3Info 方法

  • 项目

提供由 FunctionEnter3WithInfo 函数向探查器报告之函数的堆栈帧和自变量信息。 仅在 FunctionEnter3WithInfo 回调时可调用此方法。

语法

HRESULT GetFunctionEnter3Info(  
            [in]  FunctionID functionId,
            [in]  COR_PRF_ELT_INFO eltInfo,  
            [out] COR_PRF_FRAME_INFO *pFrameInfo,  
            [in, out] ULONG *pcbArgumentInfo,  
            [out, size_is(*pcbArgumentInfo)]  
                  COR_PRF_FUNCTION_ARGUMENT_INFO *pArgumentInfo);

参数

functionId
[in] 正在输入的函数的 FunctionID。

eltInfo
[in] 表示有关给定堆栈帧的信息的不透明的句柄。 探查器提供的 eltInfo 与 FunctionEnter3WithInfo 函数所提供的相同。

pFrameInfo
[out] 表示有关给定堆栈帧的泛型信息的不透明的句柄。 此句柄仅在探查器调用 GetFunctionEnter3Info 方法的 FunctionEnter3WithInfo 回调时有效。

pcbArgumentInfo
[in, out] 一个指针，指向 COR_PRF_FUNCTION_ARGUMENT_INFO 结构（如果是 pArgumentInfo 指向的参数范围，再加入其他 COR_PRF_FUNCTION_ARGUMENT_RANGE 结构）的总大小（以字节数为单位）。 如果指定的大小不足，将返回 ERROR_INSUFFICIENT_BUFFER，并将预期大小存储在 pcbArgumentInfo 中。 若仅为检索 *pcbArgumentInfo 的预期值而调用 GetFunctionEnter3Info，请设置 *pcbArgumentInfo=0 和 pArgumentInfo=NULL。

pArgumentInfo
[out] 指向 COR_PRF_FUNCTION_ARGUMENT_INFO 结构的指针，该结构用于描述内存中函数的自变量位置（按从左到右的顺序）。

注解

探查器必须为将进行检查的函数的 COR_PRF_FUNCTION_ARGUMENT_INFO 结构分配足够的空间，并且必须指示 pcbArgumentInfo 参数中的大小。

要求

平台：请参阅系统要求。

头文件： CorProf.idl、CorProf.h

库：CorGuids.lib

.NET Framework 版本：自 4 起可用

另请参阅