Antarmuka ICorProfilerInfo
Menyediakan metode untuk digunakan oleh profiler kode untuk berkomunikasi dengan runtime bahasa umum (CLR) guna mengontrol pemantauan peristiwa dan meminta informasi.
Catatan
Setiap metode dalam antarmuka ICorProfilerInfo mengembalikan HRESULT untuk menunjukkan keberhasilan atau kegagalan. Lihat CorError.h untuk daftar kode pengembalian yang memungkinkan.
Metode
| Metode | Deskripsi |
|---|---|
| Metode BeginInprocDebugging | Menginisialisasi dukungan penelusuran kesalahan dalam proses. Metode ini usang dalam .NET Framework versi 2.0. |
| Metode EndInprocDebugging | Mematikan sesi penelusuran kesalahan dalam proses. Metode ini usang dalam .NET Framework versi 2.0. |
| Metode ForceGC | Memaksa pengumpulan sampah terjadi dalam runtime bahasa umum. |
| Metode GetAppDomainInfo | Mendapatkan informasi tentang domain aplikasi yang ditentukan. |
| Metode GetAssemblyInfo | Mendapatkan informasi tentang rakitan yang ditentukan. |
| Metode GetClassFromObject | Mendapatkan ClassID dariobjek, mengingat ObjectID miliknya. |
| Metode GetClassFromToken | Mendapatkan ID kelas, mengingat token metadata. Metode ini usang dalam .NET Framework versi 2.0. Gunakan metode ICorProfilerInfo2::GetClassFromTokenAndTypeArgs sebagai gantinya. |
| Metode GetClassIDInfo | Mendapatkan modul induk dan token metadata untuk kelas yang ditentukan. |
| Metode GetCodeInfo | Mendapatkan tingkat kode asli yang terkait dengan ID fungsi yang ditentukan. Metode ini sudah usang. Gunakan metode ICorProfilerInfo2::GetCodeInfo2 sebagai gantinya. |
| Metode GetCurrentThreadID | Mendapatkan ID dari utas saat ini, jika utas tersebut adalah utas terkelola. |
| GetEventMask Method | Mendapatkan kategori peristiwa saat ini yang notifikasi peristiwanya ingin diterima profiler dari CLR. |
| Metode GetFunctionFromIP | Memetakan penunjuk instruksi kode terkelola ke FunctionID. |
| Metode GetFunctionFromToken | Mendapatkan ID fungsi. Metode ini usang dalam .NET Framework versi 2.0. Gunakan metode ICorProfilerInfo2::GetFunctionFromTokenAndTypeArgs sebagai gantinya. |
| Metode GetFunctionInfo | Mendapatkan kelas induk dan token metadata untuk fungsi yang ditentukan. |
| Metode GetHandleFromThread | Memetakan ID utas ke handel utas Win32. |
| Metode GetILFunctionBody | Mendapatkan penunjuk ke isi metode dalam kode bahasa perantara umum (CIL), dimulai dari headernya. |
| Metode GetILFunctionBodyAllocator | Mendapatkan antarmuka yang menyediakan metode untuk mengalokasikan memori yang akan digunakan untuk bertukar isi metode dalam kode CIL. |
| Metode GetILToNativeMapping | Mendapatkan peta dari offset CIL ke offset asli untuk kode yang terkandung dalam fungsi yang ditentukan. |
| Metode GetInprocInspectionInterface | Mendapatkan objek yang dapat dikueri untuk antarmuka ICorDebugProcess. Metode ini usang dalam .NET Framework versi 2.0. |
| Metode GetInprocInspectionIThisThread | Mendapatkan objek yang dapat dikueri untuk antarmuka ICorDebugThread. Metode ini usang dalam .NET Framework versi 2.0. |
| Metode GetModuleInfo | Mengingat ID modul, mengembalikan nama file modul dan ID rakitan induk modul. |
| Metode GetModuleMetaData | Mendapatkan instans antarmuka metadata yang memetakan ke modul yang ditentukan. |
| Metode GetObjectSize | Mendapatkan ukuran objek tertentu. |
| Metode GetThreadContext | Mendapatkan identitas konteks yang saat ini terkait dengan utas yang ditentukan. |
| Metode GetThreadInfo | Mendapatkan identitas utas Win32 saat ini untuk utas yang ditentukan. |
| Metode GetTokenAndMetadataFromFunction | Mendapatkan token metadata dan instans antarmuka metadata yang dapat digunakan terhadap token untuk fungsi yang ditentukan. |
| Metode IsArrayClass | Menentukan apakah kelas yang ditentukan adalah kelas array. |
| Metode SetEnterLeaveFunctionHooks | Menentukan fungsi yang diterapkan profiler yang akan dipanggil pada kait "enter", "leave", dan "tailcall" dari fungsi terkelola. |
| SetEventMask Method | Menetapkan nilai yang menentukan jenis peristiwa yang notifikasi peristiwanya ingin diterima profiler dari CLR. |
| Metode SetFunctionIDMapper | Menentukan fungsi yang diterapkan profiler yang akan dipanggil untuk memetakan nilai FunctionID ke nilai alternatif, yang diteruskan ke kait masuk/keluar fungsi profiler. |
| Metode SetFunctionReJIT | Tidak diterapkan. Jangan gunakan. |
| Metode SetILFunctionBody | Menggantikan isi fungsi yang ditentukan dalam modul yang ditentukan. |
| Metode SetILInstrumentedCodeMap | Menentukan bagaimana offset dari peta CIL asli fungsi tertentu ke offset baru dari CIL yang dimodifikasi profiler fungsi. |
Keterangan
Sebuah profiler memanggil metode di antarmuka ICorProfilerInfo untuk berkomunikasi dengan CLR guna mengontrol pemantauan peristiwa dan meminta informasi.
Metode antarmuka ICorProfilerInfo diterapkan oleh runtime bahasa umum menggunakan model utas bebas. Setiap metode mengembalikan HRESULT untuk menunjukkan keberhasilan atau kegagalan. Lihat CorError.h untuk daftar kode pengembalian yang memungkinkan.
CLR meneruskan, melalui penerapan profiler dari ICorProfilerCallback::Initialize, antarmuka ICorProfilerInfo untuk setiap profiler kode selama inisialisasi. Profiler kode kemudian dapat memanggil metode antarmuka ICorProfilerInfo untuk mendapatkan informasi tentang kode terkelola yang dijalankan di bawah kendali CLR.
Persyaratan
Platform: Lihat Persyaratan Sistem.
Header: CorProf.idl, CorProf.h
Pustaka: CorGuids.lib
Versi .NET Framework: Tersedia mulai dari 2.0
