Bagikan melalui

Antarmuka ICorProfilerCallback2

  • Artikel

Menyediakan metode yang digunakan oleh runtime bahasa umum (CLR) untuk memberi tahu profiler kode saat peristiwa yang menjadi langganan profiler terjadi. Antarmuka ICorProfilerCallback2 adalah ekstensi dari antarmuka ICorProfilerCallback. Artinya, ia menyediakan panggilan balik baru yang diperkenalkan dalam .NET Framework versi 2.0.

Catatan

Setiap penerapan metode harus menampilkan HRESULT yang memiliki nilai S_OK pada keberhasilan atau E_FAIL pada kegagalan. Saat ini, CLR mengabaikan HRESULT yang ditampilkan oleh setiap panggilan balik kecuali ICorProfilerCallback::ObjectReferences.

Metode

Metode Deskripsi
Metode FinalizeableObjectQueued Memberi tahu profiler kode bahwa objek dengan finalizer telah diantrekan ke utas finalizer untuk menjalankan metode Finalize-nya.
Metode GarbageCollectionFinished Memberi tahu profiler bahwa pengumpulan sampah telah selesai dan semua panggilan balik pengumpulan sampah telah dikeluarkan untuk itu.
Metode GarbageCollectionStarted Memberi tahu profiler kode bahwa pengumpulan sampah telah dimulai.
Metode HandleCreated Memberi tahu profiler kode bahwa handel pengumpulan sampah telah dibuat.
Metode HandleDestroyed Memberi tahu profiler kode bahwa handel pengumpulan sampah telah dihancurkan.
Metode RootReferences2 Memberi tahu profiler tentang referensi akar setelah pengumpulan sampah terjadi. Metode ini adalah ekstensi dari metode ICorProfilerCallback::RootReferences.
Metode SurvivingReferences Memberi tahu profiler tentang referensi objek yang selamat dari pengumpulan sampah.
Metode ThreadNameChanged Memberi tahu profiler kode bahwa nama utas telah berubah.

Keterangan

CLR memanggil metode di antarmuka ICorProfilerCallback (atau ICorProfilerCallback2) untuk memberi tahu profiler saat suatu peristiwa, yang menjadi langganan profiler, terjadi. Ini adalah antarmuka panggilan balik utama di mana CLR berkomunikasi dengan profiler kode.

Profiler kode harus menerapkan metode dari antarmuka ICorProfilerCallback. Untuk .NET Framework versi 2.0 dan yang lebih baru, profiler juga harus menerapkan metode ICorProfilerCallback2. Setiap penerapan metode harus menampilkan HRESULT yang memiliki nilai S_OK pada keberhasilan atau E_FAIL pada kegagalan. Saat ini, CLR mengabaikan HRESULT yang ditampilkan oleh setiap panggilan balik kecuali ICorProfilerCallback::ObjectReferences.

Profiler kode harus mendaftar di registri Microsoft Windows, objek COM-nya yang menerapkan antarmuka ICorProfilerCallback dan ICorProfilerCallback2. Seorang profiler kode berlangganan peristiwa yang ingin menerima pemberitahuan dengan memanggil ICorProfilerInfo::SetEventMask. Ini biasanya dilakukan dalam penerapan ICorProfilerCallback::Initialize oleh profiler. Profiler kemudian dapat menerima pemberitahuan dari runtime saat suatu peristiwa akan terjadi atau baru saja terjadi dalam proses runtime yang sedang dijalankan.

Catatan

Profiler mendaftarkan satu objek COM. Jika profiler menargetkan .NET Framework versi 1.0 atau 1.1, objek COM tersebut hanya perlu menerapkan metode ICorProfilerCallback. Jika profiler menargetkan .NET Framework versi 2.0 dan yang lebih baru, objek COM juga harus menerapkan metode ICorProfilerCallback2.

Persyaratan

Platform: Lihat Persyaratan Sistem.

Header: CorProf.idl, CorProf.h

Pustaka: CorGuids.lib

Versi .NET Framework: Tersedia mulai dari 2.0

Lihat juga