Bagikan melalui

Fungsi FunctionLeave3WithInfo

  • Artikel

Memberi tahu profiler bahwa kontrol sedang dikembalikan dari suatu fungsi dan memberikan handel yang dapat diteruskan ke metode ICorProfilerInfo3::GetFunctionLeave3Info untuk mengambil bingkai tumpukan dan nilai pengembalian.

Sintaks

void __stdcall FunctionLeave3WithInfo(  
               [in] FunctionIDOrClientID functionIDOrClientID,  
               [in] COR_PRF_ELT_INFO eltInfo);

Parameter

functionIDOrClientID [in] Pengidentifikasi fungsi tempat kontrol dikembalikan.

eltInfo [in] Handel buram yang mewakili informasi tentang bingkai tumpukan tertentu. Handel ini hanya berlaku selama panggilan balik yang diteruskan.

Keterangan

Metode panggilan balik FunctionLeave3WithInfo memberi tahu profiler saat fungsi dipanggil dan memungkinkan profiler menggunakan metode ICorProfilerInfo3::GetFunctionLeave3Info untuk memeriksa nilai yang ditampilkan. Untuk mengakses informasi nilai yang ditampilkan, bendera COR_PRF_ENABLE_FUNCTION_RETVAL harus diatur. Profiler dapat menggunakan metode ICorProfilerInfo::SetEventMask untuk mengatur bendera peristiwa, lalu menggunakan metode ICorProfilerInfo3::SetEnterLeaveFunctionHooks3WithInfo untuk mendaftarkan penerapan anda atas fungsi ini.

Fungsi FunctionLeave3WithInfo adalah panggilan balik; Anda harus menerapkannya. Penerapan harus menggunakan atribut kelas penyimpanan __declspec(naked).

Mesin eksekusi tidak menyimpan register apa pun sebelum memanggil fungsi ini.

  • Saat masuk, Anda harus menyimpan semua register yang Anda gunakan, termasuk yang ada di floating-point unit (FPU).

  • Saat keluar, Anda harus memulihkan tumpukan dengan memunculkan semua parameter yang didorong oleh pemanggilnya.

Penerapan FunctionLeave3WithInfo tidak boleh memblokir karena akan menunda pengumpulan sampah. Penerapan tidak boleh mencoba pengumpulan sampah, karena tumpukannya mungkin tidak dalam keadaan yang ramah akan pengumpulan sampah. Jika pengumpulan sampah dicoba, runtime akan memblokir hingga FunctionLeave3WithInfo kembali.

Fungsi FunctionLeave3WithInfo tidak boleh memanggil kode terkelola atau menyebabkan alokasi memori terkelola dengan cara apa pun.

Persyaratan

Platform: Lihat Persyaratan Sistem.

Header: CorProf.idl

Pustaka: CorGuids.lib

Versi .NET Framework: Tersedia mulai dari 4

Lihat juga