Aracılığıyla paylaş

ICorProfilerCallback Arabirimi

  • Makale

Profil oluşturucunun abone olduğu olaylar gerçekleştiğinde bir kod profil oluşturucuyu bilgilendirmek için ortak dil çalışma zamanı (CLR) tarafından kullanılan yöntemler sağlar.

Yöntemler

Yöntem Açıklama
AppDomainCreationFinished Yöntemi Profil oluşturucuya bir uygulama etki alanının oluşturulduğunu bildirir.
AppDomainCreationStarted Yöntemi Profil oluşturucuya bir uygulama etki alanının oluşturulduğunu bildirir.
AppDomainShutdownFinished Yöntemi Profil oluşturucuya uygulama etki alanının bir işlemden kaldırıldığını bildirir.
AppDomainShutdownStarted Yöntemi Profil oluşturucuya bir uygulama etki alanının bir işlemden kaldırıldığını bildirir.
AssemblyLoadFinished Yöntemi Profil oluşturucuya bir derlemenin yüklenmesinin tamamlandığını bildirir.
AssemblyLoadStarted Yöntemi Profil oluşturucuya bir derlemenin yüklendiğini bildirir.
AssemblyUnloadFinished Yöntemi Profil oluşturucuya bir derlemenin kaldırıldığını bildirir.
AssemblyUnloadStarted Yöntemi Profil oluşturucuya bir derlemenin kaldırıldığını bildirir.
ClassLoadFinished Yöntemi Profil oluşturucuya bir sınıfın yüklenmesinin tamamlandığını bildirir.
ClassLoadStarted Yöntemi Profil oluşturucuya bir sınıfın yüklendiğini bildirir.
ClassUnloadFinished Yöntemi Profil oluşturucuya bir sınıfın yüklemesinin tamamlandığını bildirir.
ClassUnloadStarted Yöntemi Profil oluşturucuya bir sınıfın kaldırıldığını bildirir.
COMClassicVTableCreated Yöntemi Belirtilen IID ve sınıf için çalışma zamanı çağrılabilen sarmalayıcının (RCW) oluşturulduğunu profil oluşturucuya bildirir.
COMClassicVTableDestroyed Yöntemi Profil oluşturucuya bir RCW'nin yok edildiğini bildirir.
ExceptionCatcherEnter Yöntemi Denetimin uygun catch bloğa geçirildiğini profil oluşturucuya bildirir.
ExceptionCatcherLeave Yöntemi Denetimin uygun catch bloktan geçirildiğini profil oluşturucuya bildirir.
ExceptionCLRCatcherExecute Yöntemi .NET Framework sürüm 2.0'da kullanımdan kaldırıldı.
ExceptionCLRCatcherFound Yöntemi .NET Framework 2.0'da kullanımdan kaldırıldı.
ExceptionOSHandlerEnter Yöntemi Uygulanmaz. Yönetilmeyen özel durum bilgilerine ihtiyaç duyan bir profil oluşturucu bu bilgileri başka yollarla almalıdır.
ExceptionOSHandlerLeave Yöntemi Uygulanmaz. Yönetilmeyen özel durum bilgilerine ihtiyaç duyan bir profil oluşturucu bu bilgileri başka yollarla almalıdır.
ExceptionSearchCatcherFound Yöntemi Özel durum işlemenin arama aşamasında oluşturulan özel durum için bir işleyici bulunduğunu profil oluşturucuya bildirir.
ExceptionSearchFilterEnter Yöntemi Profil oluşturucuya bir kullanıcı filtresinin yürütülmekte olduğunu bildirir.
ExceptionSearchFilterLeave Yöntemi Profil oluşturucuya bir kullanıcı filtresinin yürütmeyi tamamlandığını bildirir.
ExceptionSearchFunctionEnter Yöntemi Profil oluşturucuya özel durum işlemenin arama aşamasının bir işlev girdiğinizi bildirir.
ExceptionSearchFunctionLeave Yöntemi Profil oluşturucuya, özel durum işlemenin arama aşamasının bir işlevi aramayı bitirdiğini bildirir.
ExceptionThrown Yöntemi Profil oluşturucuya bir özel durumun oluştuğuna dair bir not alır.
ExceptionUnwindFinallyEnter Yöntemi Profil oluşturucuya, özel durum işlemenin geri sarma aşamasının belirtilen işlevde bulunan bir finally yan tümceye girdiğini bildirir.
ExceptionUnwindFinallyLeave Yöntemi Profil oluşturucuya özel durum işlemenin geri sarma aşamasının bir finally yan tümce bıraktığını bildirir.
ExceptionUnwindFunctionEnter Yöntemi Profil oluşturucuya özel durum işlemenin geri sarma aşamasının bir işlev girdiğinizi bildirir.
ExceptionUnwindFunctionLeave Yöntemi Profil oluşturucuya, özel durum işlemenin geri sarma aşamasının bir işlevi geri sarmayı bitirdiğini bildirir.
FunctionUnloadStarted Yöntemi Profil oluşturucuya çalışma zamanının bir işlevi kaldırmaya başladığını bildirir.
Initialize Yöntemi Yeni bir CLR uygulaması başlatıldığında profil oluşturucuyu başlatmak için çağrılır.
JITCachedFunctionSearchFinished Yöntemi Profil oluşturucuya, daha önce NGen.exe kullanılarak derlenmiş bir işlev için aramanın tamamlandığını bildirir.
JITCachedFunctionSearchStarted Yöntemi Profil oluşturucuya daha önce NGen.exe kullanılarak derlenmiş bir işlev için arama başlatıldığını bildirir.
JITCompilationFinished Yöntemi Profil oluşturucuya JIT derleyicisinin bir işlevi derlemeyi tamamladığını bildirir.
JITCompilationStarted Yöntemi Profil oluşturucuya, tam zamanında (JIT) derleyicisinin bir işlev derlemeye başladığını bildirir.
JITFunctionPitched Yöntemi Profil oluşturucuya JIT ile derlenmiş bir işlevin bellekten kaldırıldığını bildirir.
JITInlining Yöntemi Profil oluşturucuya JIT derleyicisinin başka bir işlevle aynı hizaya bir işlev eklemek üzere olduğunu bildirir.
ManagedToUnmanagedTransition Yöntemi Profil oluşturucuya yönetilen koddan yönetilmeyen koda geçişin gerçekleştiğini bildirir.
ModuleAttachedToAssembly Yöntemi Profil oluşturucuya bir modülün üst derlemesine eklendiğini bildirir.
ModuleLoadFinished Yöntemi Bir modülün yüklenmesinin tamamlandığını profil oluşturucuya bildirir.
ModuleLoadStarted Yöntemi Profil oluşturucuya bir modülün yüklendiğini bildirir.
ModuleUnloadFinished Yöntemi Profil oluşturucuya modülün kaldırılmasının tamamlandığını bildirir.
ModuleUnloadStarted Yöntemi Profil oluşturucuya bir modülün kaldırıldığını bildirir.
MovedReferences Yöntemi Çöp toplama sırasında taşınan nesne başvuruları hakkında profil oluşturucuya bildirir.
ObjectAllocated Yöntemi Profil oluşturucuya yığın içindeki belleğin bir nesne için ayrıldığını bildirir.
ObjectReferences Yöntemi Belirtilen nesne tarafından başvuruda bulunan bellekteki nesneler hakkında profil oluşturucuya bildirir.
ObjectsAllocatedByClass Yöntemi Profil oluşturucuya, önceki çöp toplamadan bu yana oluşturulan belirtilen her sınıfın örnek sayısı hakkında bilgi verir.
RemotingClientInvocationFinished Yöntemi Bir uzaktan iletişim çağrısının istemcide tamamlanmak üzere çalıştırıldığını profil oluşturucuya bildirir.
RemotingClientInvocationStarted Yöntemi Profil oluşturucuya uzaktan iletişim çağrısının başlatıldığını bildirir.
RemotingClientReceivingReply Yöntemi Uzaktan iletişim çağrısının sunucu tarafı bölümünün tamamlandığını ve istemcinin yanıtı almakta olduğunu ve işlemek üzere olduğunu profil oluşturucuya bildirir.
RemotingClientSendingMessage Yöntemi Profil oluşturucuya istemcinin sunucuya istek gönderdiğini bildirir.
RemotingServerInvocationReturned Yöntemi Profil oluşturucuya, uzak yöntem çağırma isteğine yanıt olarak bir yöntemi çağırma işleminin tamamlandığını bildirir.
RemotingServerInvocationStarted Yöntemi Profil oluşturucuya, işlemin uzak yöntem çağırma isteğine yanıt olarak bir yöntemi çağırdığını bildirir.
RemotingServerReceivingMessage Yöntemi Profil oluşturucuya işlemin uzak yöntem çağrısı veya etkinleştirme isteği aldığını bildirir.
RemotingServerSendingReply Yöntemi Profil oluşturucuya, işlemin uzak yöntem çağırma isteğini işlemeyi bitirdiğini ve yanıtı bir kanal üzerinden iletmek üzere olduğunu bildirir.
RootReferences Yöntemi Çöp toplamadan sonra profil oluşturucuya kök başvurular hakkında bilgi ile bildirir.
RuntimeResumeFinished Yöntemi Profil oluşturucuya çalışma zamanının tüm çalışma zamanı iş parçacıklarını sürdürdüğünü ve normal işleme döndürdüğünü bildirir.
RuntimeResumeStarted Yöntemi Profil oluşturucuya çalışma zamanının tüm çalışma zamanı iş parçacıklarını devam ettirdiğini bildirir.
RuntimeSuspendAborted Yöntemi Profil oluşturucuya çalışma zamanının gerçekleşen çalışma zamanı askıya alma işlemini durdurduğunu bildirir.
RuntimeSuspendFinished Yöntemi Profil oluşturucuya çalışma zamanının tüm çalışma zamanı iş parçacıklarının askıya alınmasını tamamladığını bildirir.
RuntimeSuspendStarted Yöntemi Profil oluşturucuya çalışma zamanının tüm çalışma zamanı iş parçacıklarını askıya almak üzere olduğunu bildirir.
RuntimeThreadResumed Yöntemi Belirtilen iş parçacığının askıya alındıktan sonra sürdürüldüğünü profil oluşturucuya bildirir.
RuntimeThreadSuspended Yöntemi Belirtilen iş parçacığının askıya alındığını veya askıya alınmak üzere olduğunu profil oluşturucuya bildirir.
Shutdown Yöntemi Profil oluşturucuya uygulamanın kapatıldığını bildirir.
ThreadAssignedToOSThread Yöntemi Belirli bir işletim sistemi (OS) iş parçacığı kullanılarak yönetilen bir iş parçacığının uygulandığını profil oluşturucuya bildirir.
ThreadCreated Yöntemi Profil oluşturucuya bir iş parçacığının oluşturulduğunu bildirir.
ThreadDestroyed Yöntemi Profil oluşturucuya bir iş parçacığının yok edildiğini bildirir.
UnmanagedToManagedTransition Yöntemi Profil oluşturucuya yönetilmeyen koddan yönetilen koda geçişin gerçekleştiğini bildirir.

Açıklamalar

CLR, profil oluşturucunun ICorProfilerCallback abone olduğu bir olay gerçekleştiğinde profil oluşturucuyu bilgilendirmek için (veya ICorProfilerCallback2) arabiriminde bir yöntem çağırır. Bu, CLR'nin kod profil oluşturucu ile iletişim kurduğu birincil geri çağırma arabirimidir.

Bir kod profil oluşturucu arabiriminin ICorProfilerCallback yöntemlerini uygulamalıdır. .NET Framework sürüm 2.0 veya üzeri için profil oluşturucunun ICorProfilerCallback2 yöntemleri de uygulaması gerekir. Her yöntem uygulaması, başarıda S_OK değerine veya hata durumunda E_FAIL bir HRESULT döndürmelidir. Şu anda CLR, ICorProfilerCallback::ObjectReferences dışında her geri çağırma tarafından döndürülen HRESULT'u yoksayar.

Microsoft Windows kayıt defterinde, kod profil oluşturucunun ve ICorProfilerCallback2 arabirimlerini uygulayan Bileşen Nesne Modeli (COM) nesnesini kaydetmesi ICorProfilerCallback gerekir. Kod profili oluşturucu , ICorProfilerInfo::SetEventMask çağrısı yaparak bildirim almak istediği olaylara abone olur. Bu genellikle profil oluşturucunun ICorProfilerCallback::Initialize uygulamasında yapılır. Profil oluşturucu daha sonra, bir olay gerçekleşmek üzere olduğunda veya yürütme çalışma zamanı işleminde yeni oluştuğunda çalışma zamanından bildirim alabilir.

Not

Profil oluşturucu tek bir COM nesnesi kaydeder. Profil oluşturucu .NET Framework sürüm 1.0 veya 1.1'i hedefliyorsa, bu COM nesnesinin yalnızca yöntemlerini ICorProfilerCallbackuygulaması gerekir. .NET Framework sürüm 2.0 veya sonraki bir sürümü hedefliyorsa, COM nesnesinin de yöntemlerini ICorProfilerCallback2uygulaması gerekir.

Gereksinimler

Platform: Bkz. Sistem Gereksinimleri.

Üstbilgi: CorProf.idl, CorProf.h

Kitaplığı: CorGuids.lib

.NET Framework Sürümleri: 1.0 sürümünden itibaren kullanılabilir

Ayrıca bkz.