ICorProfilerCallback::JITCachedFunctionSearchStarted metódus

Értesíti a profilkészítőt arról, hogy a natív képgenerátor (NGen.exe) használatával korábban lefordított függvény keresése megkezdődött.

Szintaxis

HRESULT JITCachedFunctionSearchStarted(  
    [in]  FunctionID functionId,  
    [out] BOOL *pbUseCachedFunction);  

Paraméterek

functionId
[in] Annak a függvénynek az azonosítója, amelyhez a keresést végzik.

pbUseCachedFunction
[kifelé] true ha a végrehajtó motornak egy függvény gyorsítótárazott verzióját kell használnia (ha elérhető); egyéb esetben false: . Ha az érték false, a végrehajtási motor, a JIT lefordítja a függvényt ahelyett, hogy olyan verziót használ, amely nem JIT által lefordított.

Megjegyzések

A .NET-keretrendszer 2.0-s verziójában a és az JITCachedFunctionSearchStartedICorProfilerCallback::JITCachedFunctionSearchFinished Metódus visszahívása nem történik meg a normál NGen-rendszerképek összes függvényéhez. Csak a profilhoz optimalizált NGen-képek hoznak létre visszahívásokat a kép összes függvényéhez. A többletterhelés miatt azonban a profilkészítőnek csak akkor kell profilkészítőre optimalizált NGen-rendszerképeket kérnie, ha ezeket a visszahívásokat arra kívánja használni, hogy kényszerítse egy függvény igény szerinti fordítását (JIT). Ellenkező esetben a profilkészítőnek lusta stratégiát kell használnia a függvényadatok gyűjtéséhez.

A profilkészítőknek támogatniuk kell azokat az eseteket, amikor egy profilos alkalmazás több szála egyszerre hívja meg ugyanazt a módszert. Például az A szál hívásai JITCachedFunctionSearchStarted és a profilkészítő úgy válaszol, hogy a pbUseCachedFunctionbeállítást FALSE értékre állítja a JIT-fordítás kényszerítéséhez. Az A szál ezután meghívja az ICorProfilerCallback::JITCompilationStarted és az ICorProfilerCallback::JITCompilationFinished parancsot.

Most a B szál ugyanazt a függvényt hívja JITCachedFunctionSearchStarted meg. Annak ellenére, hogy a profilkészítő kinyilvánította szándékát a függvény JIT-fordítására, a profilkészítő megkapja a második visszahívást, mivel a B szál elküldi a visszahívást, mielőtt a profilkészítő válaszolna az A szál hívására JITCachedFunctionSearchStarted. A szálak hívásainak sorrendje attól függ, hogy a szálak hogyan vannak ütemezve.

Amikor a profilkészítő ismétlődő visszahívásokat kap, a hivatkozott pbUseCachedFunction értéket ugyanarra az értékre kell állítania az összes ismétlődő visszahívás esetében. Vagyis ha JITCachedFunctionSearchStarted a rendszer többször is meghívja ugyanazt functionId az értéket, a profilkészítőnek minden alkalommal ugyanazt kell válaszolnia.

Követelmények

Platformok: Lásd: Rendszerkövetelmények.

Fejléc: CorProf.idl, CorProf.h

Könyvtár: CorGuids.lib

.NET-keretrendszer verziók: 2.0 óta elérhető

Lásd még

• ICorProfilerCallback felület