FunctionEnter2 函式

發行項
08/21/2008

更新：2007 年 11 月

向分析工具告知，控制項已傳遞至函式，並提供堆疊框架 (Stack Frame) 和函式引數的相關資訊。

void FunctionEnter2 (
        [in]  FunctionID                       funcId, 
        [in]  UINT_PTR                         clientData, 
        [in]  COR_PRF_FRAME_INFO               func, 
        [in]  COR_PRF_FUNCTION_ARGUMENT_INFO  *argumentInfo
);

參數

funcId
[in] 傳遞控制項之目標函式的識別項。
clientData
[in] 分析工具先前透過 FunctionIDMapper 函式指定之重新對應的函式識別項。
func
[in] 指向堆疊框架相關資訊的 COR_PRF_FRAME_INFO 值。

分析工具應該將它視為不透明控制代碼；此控制代碼可以傳回至 ICorProfilerInfo2::GetFunctionInfo2 方法中的執行引擎。
argumentInfo
[in] COR_PRF_FUNCTION_ARGUMENT_INFO 結構的指標，指定記憶體中函式引數的位置。

若要存取引數資訊，必須設定 COR_PRF_ENABLE_FUNCTION_ARGS 旗標。分析工具可以使用 ICorProfilerInfo::SetEventMask 方法來設定事件旗標。