Skip to content

Latest commit

 

History

History
74 lines (56 loc) · 3.47 KB

icorprofilerinfo3-getfunctionenter3info-method.md

File metadata and controls

74 lines (56 loc) · 3.47 KB
Raw
description title ms.date api_name api_location api_type f1_keywords helpviewer_keywords ms.assetid topic_type
Learn more about: ICorProfilerInfo3::GetFunctionEnter3Info Method
ICorProfilerInfo3::GetFunctionEnter3Info Method
03/30/2017
ICorProfilerInfo3.GetFunctionEnter3Info Method
Mscorwks.dll
COM
ICorProfilerInfo3::GetFunctionEnter3Info
GetFunctionEnter3Info method [.NET Framework profiling]
ICorProfilerInfo3::GetFunctionEnter3Info method [.NET Framework profiling]
542c7c65-dd56-4651-b76f-5db2465e4a15
apiref

ICorProfilerInfo3::GetFunctionEnter3Info Method

Provides the stack frame and argument information of the function that is being reported to the profiler by the FunctionEnter3WithInfo function. This method can be called only during the FunctionEnter3WithInfo callback.

Syntax

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);

Parameters

functionId
[in] The FunctionID of the function that is being entered.

eltInfo
[in] An opaque handle that represents information about a given stack frame. The profiler should provide the same eltInfo that it was given by the FunctionEnter3WithInfo function.

pFrameInfo
[out] An opaque handle that represents generics information about a given stack frame. This handle is valid only during the FunctionEnter3WithInfo callback in which the profiler called the GetFunctionEnter3Info method.

pcbArgumentInfo
[in, out] A pointer to the total size, in bytes, of the COR_PRF_FUNCTION_ARGUMENT_INFO structure (plus any additional COR_PRF_FUNCTION_ARGUMENT_RANGE structures for the argument ranges pointed to by pArgumentInfo). If the specified size is not enough, ERROR_INSUFFICIENT_BUFFER is returned and the expected size is stored in pcbArgumentInfo. To call GetFunctionEnter3Info just to retrieve the expected value for *pcbArgumentInfo, set *pcbArgumentInfo=0 and pArgumentInfo=NULL.

pArgumentInfo
[out] A pointer to a COR_PRF_FUNCTION_ARGUMENT_INFO structure that describes the locations of the function's arguments in memory, in left-to-right order.

Remarks

The profiler must allocate sufficient space for the COR_PRF_FUNCTION_ARGUMENT_INFO structure of the function that is being inspected, and must indicate the size in the pcbArgumentInfo parameter.

Requirements

Platforms: See System Requirements.

Header: CorProf.idl, CorProf.h

Library: CorGuids.lib

.NET Framework Versions: [!INCLUDEnet_current_v40plus]

See also