FunctionEnter3WithInfo 함수

  • 아티클

컨트롤이 함수에 전달되고 있음을 프로파일러에 알리고 스택 프레임 및 함수 인수를 검색하기 위해 ICorProfilerInfo3::GetFunctionEnter3Info 메서드에 전달될 수 있는 핸들을 제공합니다.

구문

void __stdcall FunctionEnter3WithInfo(  
               [in] FunctionIDOrClientID functionIDOrClientID,  
               [in] COR_PRF_ELT_INFO eltInfo);

매개 변수

functionIDOrClientID [in] 컨트롤이 전달되는 함수의 식별자입니다.

eltInfo [in] 지정된 스택 프레임에 대한 정보를 나타내는 불투명 핸들입니다. 이 핸들은 전달된 콜백 동안에만 유효합니다.

설명

FunctionEnter3WithInfo 콜백 메서드는 함수가 호출될 때 프로파일러에 알리고 프로파일러가 ICorProfilerInfo3::GetFunctionEnter3Info 메서드를 사용하여 인수 값을 검사할 수 있도록 합니다. 인수 정보에 액세스하려면 COR_PRF_ENABLE_FUNCTION_ARGS 플래그를 설정해야 합니다. 프로파일러는 ICorProfilerInfo::SetEventMask 메서드를 사용하여 이벤트 플래그를 설정한 다음, ICorProfilerInfo3::SetEnterLeaveFunctionHooks3WithInfo 메서드를 사용하여 이 함수의 구현을 등록할 수 있습니다.

FunctionEnter3WithInfo 함수는 콜백이며, 구현해야 합니다. 구현하려면 __declspec(naked) 스토리지 클래스 특성을 사용해야 합니다.

실행 엔진은 이 함수를 호출하기 전에 레지스터를 저장하지 않습니다.

  • 입력 시 FPU(부동 소수점 유닛)의 레지스터를 포함하여 사용하는 모든 레지스터를 저장해야 합니다.

  • 종료 시 호출자가 푸시한 모든 매개 변수를 제거하여 스택을 복원해야 합니다.

가비지 수집이 지연되므로 FunctionEnter3WithInfo 구현을 차단해서는 안 됩니다. 스택이 가비지 수집 친화적 상태가 아닐 수 있으므로 구현 시 가비지 수집을 시도해서는 안 됩니다. 가비지 수집이 시도되면 런타임은 FunctionEnter3WithInfo가 반환될 때까지 차단됩니다.

FunctionEnter3WithInfo 함수는 관리형 코드를 호출하거나 관리형 메모리 할당을 어떤 식으로든 유발해서는 안 됩니다.

요구 사항

플랫폼:시스템 요구 사항을 참조하세요.

헤더: CorProf.idl

라이브러리: CorGuids.lib

.NET Framework 버전: 2.0부터 사용 가능

참고 항목