Notifies the profiler that control is being passed to a function and provides information about the stack frame and function arguments. This function supersedes the FunctionEnter function.
void __stdcall FunctionEnter2 ( [in] FunctionID funcId, [in] UINT_PTR clientData, [in] COR_PRF_FRAME_INFO func, [in] COR_PRF_FUNCTION_ARGUMENT_INFO *argumentInfo );
[in] The identifier of the function to which control is passed.
[in] The remapped function identifier, which the profiler previously specified by using the FunctionIDMapper function.
COR_PRF_FRAME_INFO value that points to information about the stack frame.
The profiler should treat this as an opaque handle that can be passed back to the execution engine in the ICorProfilerInfo2::GetFunctionInfo2 method.
[in] A pointer to a COR_PRF_FUNCTION_ARGUMENT_INFO structure that specifies the locations in memory of the function's arguments.
In order to access argument information, the
COR_PRF_ENABLE_FUNCTION_ARGS flag must be set. The profiler can use the ICorProfilerInfo::SetEventMask method to set the event flags.
The values of the
argumentInfo parameters are not valid after the
FunctionEnter2 function returns because the values may change or be destroyed.
FunctionEnter2 function is a callback; you must implement it. The implementation must use the
naked) storage-class attribute.
The execution engine does not save any registers before calling this function.
On entry, you must save all registers that you use, including those in the floating-point unit (FPU).
On exit, you must restore the stack by popping off all the parameters that were pushed by its caller.
The implementation of
FunctionEnter2 should not block because it will delay garbage collection. The implementation should not attempt a garbage collection because the stack may not be in a garbage collection-friendly state. If a garbage collection is attempted, the runtime will block until
FunctionEnter2 function must not call into managed code or in any way cause a managed memory allocation.
Platforms: See System Requirements.
.NET Framework Versions: Available since 2.0