ICorProfilerInfo3::SetEnterLeaveFunctionHooks3 메서드

아티클
08/09/2011

FunctionEnter3, FunctionLeave3 및 FunctionTailcall3 함수에서 호출될 프로파일러 구현 함수를 지정합니다.

HRESULT SetEnterLeaveFunctionHooks3(
            [in] FunctionEnter3    *pFuncEnter3,
            [in] FunctionLeave3    *pFuncLeave3,
            [in] FunctionTailcall3 *pFuncTailcall3);

매개 변수

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

설명

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

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

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