Aracılığıyla paylaş

ICorProfilerCallback2 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. 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 ICorProfilerCallbackuygulaması gerekir. .NET Framework sürüm 2.0 ve üzerini 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: 2.0 sürümünden itibaren kullanılabilir

Ayrıca bkz.