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] 代表特定堆疊框架之資訊的不透明控制代碼。 程式碼剖析工具應該提供由 FunctionEnter3WithInfo 函式所提供給它的相同 eltInfo。

pFrameInfo
[out] 代表特定堆疊框架之泛型資訊的不透明控制代碼。 此控制代碼只有在程式碼剖析工具呼叫 GetFunctionEnter3Info 方法的 FunctionEnter3WithInfo 回呼中有效。

pcbArgumentInfo
[in， out] COR_PRF_FUNCTION_ARGUMENT_INFO 結構 (再加上 pArgumentInfo 所指向之引數範圍的任何其他 COR_PRF_FUNCTION_ARGUMENT_RANGE 結構) 的總大小 (以位元組為單位) 的指標。 如果指定的大小不足，會傳回 ERROR_INSUFFICIENT_BUFFER，且預期大小會儲存在 pcbArgumentInfo。 若要呼叫 GetFunctionEnter3Info 以擷取預期的 *pcbArgumentInfo 值，請設定 *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 起可用

另請參閱