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 起可用