Bagikan melalui

Metode IHostMemoryManager::RegisterMemoryNotificationCallback

Mendaftarkan penunjuk ke fungsi panggilan balik yang dipanggil host untuk memberi tahu runtime bahasa umum (CLR) dari beban memori saat ini di komputer.

Sintaks

HRESULT RegisterMemoryNotificationCallback (  
    [in] ICLRMemoryNotificationCallback* pCallback  
);

Parameter

pCallback
[in] Penunjuk antarmuka ke instans ICLRMemoryNotificationCallback yang diimplementasikan oleh CLR.

Tampilkan Nilai

HRESULT Deskripsi
S_OK RegisterMemoryNotificationCallback berhasil dikembalikan.
HOST_E_CLRNOTAVAILABLE Runtime bahasa umum belum dimuat ke dalam proses, atau runtime bahasa umum dalam status yaitu tidak dapat menjalankan kode aman atau memproses panggilan dengan sukses.
HOST_E_TIMEOUT Waktu panggilan habis.
HOST_E_NOT_OWNER Pemanggil tidak memiliki kunci.
HOST_E_ABANDONED Peristiwa dibatalkan saat rangkaian atau fiber yang diblokir sedang menunggunya.
E_FAIL Kegagalan katastrofe yang tidak diketahui terjadi. Saat metode menampilkan E_FAIL, CLR tidak lagi dapat digunakan dalam proses. Panggilan berikutnya ke metode hosting menampilkan HOST_E_CLRNOTAVAILABLE.

Keterangan

Karena antarmuka ICLRMemoryNotificationCallback hanya mendefinisikan satu metode (ICLRMemoryNotificationCallback::OnMemoryNotification), dan karena pCallback merupakan penunjuk ke instans ICLRMemoryNotificationCallback yang disediakan oleh CLR, pendaftaran secara efektif untuk fungsi panggilan balik itu sendiri. Host memanggil OnMemoryNotification untuk melaporkan kondisi tekanan memori, daripada menggunakan fungsi Win32 CreateMemoryResourceNotification standar. Untuk informasi selengkapnya, lihat dokumentasi Platform Windows.

Catatan

Panggilan untuk OnMemoryNotification tidak pernah diblokir. Panggilan selalu segera ditampilkan.

Persyaratan

Platform: Lihat Persyaratan Sistem.

Header: MSCorEE.h

Pustaka: Disertakan sebagai sumber daya di MSCorEE.dll

Versi .NET Framework: Tersedia mulai dari 2.0

Lihat juga

  • Last updated on