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 컴파일할 의도를 밝혔더라도 프로파일러가 JITCachedFunctionSearchStarted에 대한 스레드 A의 호출에 응답하기 전에 스레드 B가 콜백을 보내기 때문에 프로파일러는 두 번째 콜백을 수신합니다. 스레드가 호출하는 순서는 스레드가 예약된 방식에 따라 다릅니다.

프로파일러가 중복 콜백을 수신하는 경우 모든 중복 콜백에 대해 참조되는 pbUseCachedFunction 값을 동일한 값으로 설정해야 합니다. 즉, JITCachedFunctionSearchStarted가 동일한 functionId 값으로 여러 번 호출되면 프로파일러가 매번 동일하게 응답해야 합니다.

요구 사항

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

헤더: CorProf.idl, CorProf.h

라이브러리: CorGuids.lib

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

참고 항목

• ICorProfilerCallback 인터페이스