ICorProfilerInfo3::SetEnterLeaveFunctionHooks3WithInfo 메서드

아티클
08/09/2011

업데이트: 2010년 10월

관리되는 함수의 FunctionEnter3WithInfo, FunctionLeave3WithInfo 및 FunctionTailcall3WithInfo 후크에서 호출될 프로파일러 구현 함수를 지정합니다.

HRESULT SetEnterLeaveFunctionHooks3WithInfo(
            [in] FunctionEnter3WithInfo    *pFuncEnter3,
            [in] FunctionLeave3withInfo    *pFuncLeave3,
            [in] FunctionTailcall3WithInfo *pFuncTailcall3);

매개 변수

pFuncEnter3
[in] FunctionEnter3WithInfo 콜백으로 사용할 구현에 대한 포인터입니다.
pFuncLeave3
[in] FunctionLeave3WithInfo 콜백으로 사용할 구현에 대한 포인터입니다.
pFuncTailcall3
[in] FunctionTailcall3WithInfo 콜백으로 사용할 구현에 대한 포인터입니다.

설명

FunctionEnter3WithInfo, FunctionLeave3WithInfo 및 FunctionTailcall3WithInfo 후크는 스택 프레임 및 인수 검사를 제공합니다. 해당 정보에 액세스하려면 COR_PRF_ENABLE_FUNCTION_ARGS, COR_PRF_ENABLE_FUNCTION_RETVAL 및/또는 COR_PRF_ENABLE_FRAME_INFO 플래그를 설정해야 합니다. 프로파일러는 ICorProfilerInfo::SetEventMask 메서드를 사용하여 이벤트 플래그를 설정한 다음 SetEnterLeaveFunctionHooks3WithInfo 메서드를 사용하여 이 함수의 구현을 등록할 수 있습니다.

한 번에 한 개의 콜백 집합만 활성일 수 있으며 최신 버전이 우선합니다. 따라서 프로파일러가 SetEnterLeaveFunctionHooks2 및 SetEnterLeaveFunctionHooks3WithInfo를 둘 다 호출할 경우 SetEnterLeaveFunctionHooks3WithInfo가 사용됩니다.

SetEnterLeaveFunctionHooks3WithInfo 메서드는 프로파일러의 ICorProfilerCallback::Initialize 콜백에서만 호출할 수 있습니다.