ICorProfilerCallback::JITCachedFunctionSearchStarted 메서드
네이티브 이미지 생성기(NGen.exe)를 사용하여 이전에 컴파일한 함수에 대한 검색이 시작되었음을 프로파일러에 알립니다.
HRESULT JITCachedFunctionSearchStarted(
[in] FunctionID functionId,
[out] BOOL *pbUseCachedFunction);
매개 변수
functionId
[in] 검색이 수행되고 있는 함수의 ID입니다.pbUseCachedFunction
[out] 실행 엔진에서 캐시된 버전의 함수(사용 가능한 경우)를 사용할 경우 true이고, 그렇지 않으면 false입니다. 이 값이 false이면 실행 엔진에서는 JIT 컴파일되지 않은 버전을 사용하는 대신 함수를 JIT 컴파일합니다.
설명
.NET Framework 버전 2.0에서 JITCachedFunctionSearchStarted 및 ICorProfilerCallback::JITCachedFunctionSearchFinished Method 콜백은 일반적인 NGen 이미지의 모든 함수에 대해 생성되지는 않습니다. 프로파일에 최적화된 NGen 이미지만이 해당 이미지의 모든 함수에 대한 콜백을 생성합니다. 그러나 추가 오버헤드로 인해 프로파일러에서는 이러한 콜백을 사용하여 함수가 강제로 JIT(Just-in-time) 컴파일되도록 하려는 경우에만 프로파일러에 최적화된 NGen 이미지를 요청해야 합니다. 그렇지 않은 경우에는 프로파일러에서 지연 전략을 사용하여 함수 정보를 수집해야 합니다.
프로파일러에서는 프로파일링된 응용 프로그램의 여러 스레드에서 동일한 메서드를 동시에 호출할 경우 이를 지원해야 합니다. 예를 들어 스레드 A에서 JITCachedFunctionSearchStarted를 호출하고 프로파일러에서는 JIT 컴파일을 수행하도록 pbUseCachedFunction을FALSE로 설정하여 응답한다고 가정합니다. 그러면 스레드 A에서는 ICorProfilerCallback::JITCompilationStarted 및 ICorProfilerCallback::JITCompilationFinished를 호출합니다.
그런 다음 스레드 B에서 동일한 함수에 대해 JITCachedFunctionSearchStarted를 호출합니다. 프로파일러에서는 이미 함수를 JIT 컴파일하도록 지시했지만 스레드 A의 JITCachedFunctionSearchStarted 호출에 응답하기 전에 스레드 B에서 콜백을 보내기 때문에 두 번째 콜백을 받게 됩니다. 스레드의 호출 순서는 스레드의 예약 방식에 따라 달라집니다.
중복 콜백을 받을 경우 프로파일러에서는 pbUseCachedFunction에서 참조하는 값을 모든 중복 콜백에 대해 동일한 값으로 설정해야 합니다. 즉, 동일한 functionId를 사용하여 JITCachedFunctionSearchStarted가 여러 번 호출될 경우 프로파일러에서는 매번 동일하게 응답해야 합니다.
요구 사항
플랫폼: .NET Framework 시스템 요구 사항 참조
헤더: CorProf.idl, CorProf.h
라이브러리: CorGuids.lib
.NET Framework 버전: 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0