Bagikan melalui

Antarmuka ICorProfilerInfo3

  • Artikel

Menyediakan metode yang digunakan profiler kode untuk berkomunikasi dengan runtime bahasa umum (CLR) guna mengontrol pemantauan peristiwa dan untuk meminta informasi. Antarmuka ICorProfilerInfo3 adalah ekstensi antarmuka ICorProfilerInfo2. Antarmuka ini menyediakan metode baru yang didukung dalam versi .NET Framework 4 dan yang lebih baru.

Metode

Metode Deskripsi
Metode EnumJITedFunctions Mengembalikan enumerator untuk semua fungsi yang dikompilasi JIT sebelumnya.
Metode EnumModules Mengembalikan enumerator yang menyediakan metode untuk melakukan iterasi secara berurutan melalui kumpulan modul terkelola yang dimuat ke dalam aplikasi.
Metode GetAppDomainsContainingModule Mendapatkan pengidentifikasi domain aplikasi tempat modul yang diberikan telah dimuat.
Metode GetFunctionEnter3Info Menyediakan bingkai tumpukan dan informasi argumen dari fungsi yang dilaporkan ke profiler oleh fungsi FunctionEnter3WithInfo; hanya dapat dipanggil selama panggilan balik FunctionEnter3WithInfo.
Metode GetFunctionLeave3Info Menyediakan bingkai tumpukan dan nilai pengembalian fungsi yang sedang dilaporkan ke profiler oleh fungsi FunctionLeave3WithInfo; hanya dapat dipanggil selama panggilan balik FunctionLeave3WithInfo.
Metode GetFunctionTailcall3Info Menyediakan bingkai tumpukan fungsi yang sedang dilaporkan ke profiler oleh fungsi FunctionTailcall3WithInfo; hanya dapat dipanggil selama panggilan balik FunctionTailcall3WithInfo.
Metode GetModuleInfo2 Mengingat ID modul, mengembalikan nama file modul, ID rakitan induk modul, dan bitmask yang menjelaskan properti modul.
Metode GetRuntimeInformation Memberikan informasi versi tentang runtime bahasa umum yang sedang diprofilkan.
Metode GetStringLayout2 Mendapatkan informasi tentang tata letak objek string.
Metode GetThreadStaticAddress2 Mendapatkan alamat bidang utas statik yang ditentukan serta berada dalam cakupan utas dan domain aplikasi yang ditentukan.
Metode RequestProfilerDetach Menginstruksikan runtime bahasa umum untuk melepaskan profiler.
Metode SetEnterLeaveFunctionHooks3 Menentukan fungsi yang diterapkan profiler yang akan dipanggil pada fungsi FunctionEnter3, FunctionLeave3, dan FunctionTailcall3.
Metode SetEnterLeaveFunctionHooks3WithInfo Menentukan fungsi yang diterapkan profiler yang akan dipanggil pada kait dari fungsi terkelola FunctionEnter3WithInfo, FunctionLeave3WithInfo, dan FunctionTailcall3WithInfo.
Metode SetFunctionIDMapper2 Menentukan fungsi yang diterapkan profiler yang akan dipanggil untuk memetakan nilai FunctionID ke nilai alternatif, yang diteruskan ke kait masuk/keluar fungsi profiler. Metode ini memperluas ICorProfilerInfo::SetFunctionIDMapper dengan parameter yang dapat digunakan profiler untuk membedakan di antara runtime bahasa umum.

Keterangan

CLR menerapkan metode antarmuka ICorProfilerInfo3 dengan menggunakan model utas bebas. Setiap metode mengembalikan HRESULT untuk menunjukkan keberhasilan atau kegagalan. Untuk daftar kode pengembalian yang memungkinkan, lihat file CorError.h.

CLR meneruskan antarmuka ICorProfilerInfo3 ke setiap profiler kode selama inisialisasi, menggunakan penerapan profiler dari metode ICorProfilerCallback::Initialize atau ICorProfilerCallback3::InitializeForAttach. Profiler kode kemudian dapat memanggil metode ICorProfilerInfo3 untuk mendapatkan informasi tentang kode terkelola yang sedang dijalankan di bawah kontrol CLR.

Persyaratan

Platform: Lihat Persyaratan Sistem.

Header: CorProf.idl, CorProf.h

Pustaka: CorGuids.lib

Versi .NET Framework: Tersedia mulai dari 4

Lihat juga