ICorProfilerCallback2 Arabirimi
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. ICorProfilerCallback2
Arabirimi, ICorProfilerCallback arabiriminin bir uzantısıdır. Yani, .NET Framework sürüm 2.0'da tanıtılan yeni geri çağırmalar sağlar.
Not
Her yöntem uygulaması, başarı veya hata durumunda E_FAIL S_OK değerine sahip 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.
Yöntemler
Yöntem | Açıklama |
---|---|
FinalizeableObjectQueued Yöntemi | Sonlandırıcısı olan bir nesnenin yönteminin yürütülmesi için sonlandırıcı iş parçacığına kuyruğa alındığını kod profil oluşturucuya Finalize bildirir. |
GarbageCollectionFinished Yöntemi | Bir çöp toplama işleminin tamamlandığını ve bunun için tüm çöp toplama geri çağırmalarının verildiğini profil oluşturucuya bildirir. |
GarbageCollectionStarted Yöntemi | Kod profili oluşturucuya bir çöp toplama işleminin başlatıldığını bildirir. |
HandleCreated Yöntemi | Kod profil oluşturucusunun bir çöp toplama tanıtıcısı oluşturulduğunu bildirir. |
HandleDestroyed Yöntemi | Bir çöp toplama tanıtıcısının yok edildiğini kod profili oluşturucuya bildirir. |
RootReferences2 Yöntemi | Bir çöp toplama gerçekleştikten sonra profil oluşturucuya kök başvurular hakkında bilgi sağlar. Bu yöntem, ICorProfilerCallback::RootReferences yönteminin bir uzantısıdır . |
SurvivingReferences Yöntemi | Bir çöp toplamadan kurtulan nesne başvuruları hakkında profil oluşturucuya bildirir. |
ThreadNameChanged Yöntemi | Kod profili oluşturucuya iş parçacığının adının değiş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
) arabirimindeki bir yöntemi çağırır. Bu, CLR'nin kod profili oluşturucu ile iletişim kurduğu birincil geri çağırma arabirimidir.
Kod profil oluşturucu arabiriminin ICorProfilerCallback
yöntemlerini uygulamalıdır. .NET Framework 2.0 ve sonraki sürümler için profil oluşturucunun ICorProfilerCallback2
yöntemleri de uygulaması gerekir. Her yöntem uygulaması, başarı veya hata durumunda E_FAIL S_OK değerine sahip 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.
Bir kod profil oluşturucu, ve ICorProfilerCallback2
arabirimlerini uygulayan COM nesnesi olan Microsoft Windows kayıt defterine ICorProfilerCallback
kaydolmalıdır. 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ütülmekte olan bir çalışma zamanı işleminde meydana geldiğinde ç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 ICorProfilerCallback
uygulaması gerekir. .NET Framework sürüm 2.0 ve üzerini hedefliyorsa, COM nesnesinin de yöntemlerini ICorProfilerCallback2
uygulaması gerekir.
Gereksinimler
Platform: Bkz. Sistem Gereksinimleri.
Üstbilgi: CorProf.idl, CorProf.h
Kitaplığı: CorGuids.lib
.NET Framework Sürümleri: 2.0 sürümünden itibaren kullanılabilir
Ayrıca bkz.
Geri Bildirim
https://aka.ms/ContentUserFeedback.
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz.Gönderin ve geri bildirimi görüntüleyin