Bagikan melalui

Metode IHostMemoryManager::GetMemoryLoad

Mendapatkan jumlah memori fisik yang saat ini digunakan, dan karena itu tidak tersedia, seperti yang dilaporkan oleh host.

Sintaks

HRESULT GetMemoryLoad (  
    [out] DWORD*  pMemoryLoad,
    [out] SIZE_T  *pAvailableBytes  
);

Parameter

pMemoryLoad
[out] Penunjuk ke perkiraan persentase total memori fisik yang saat ini digunakan.

pAvailableBytes
[out] Penunjuk ke jumlah byte yang tersedia untuk runtime bahasa umum (CLR).

Tampilkan Nilai

HRESULT Deskripsi
S_OK GetMemoryLoad 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

GetMemoryLoad membungkus fungsi GlobalMemoryStatus Win32. Nilai pMemoryLoad setara dengan bidang dwMemoryLoad dalam struktur yang MEMORYSTATUS dikembalikan dari GlobalMemoryStatus.

Runtime menggunakan nilai pengembalian sebagai heuristik untuk pengumpul sampah. Misalnya, jika host melaporkan bahwa sebagian besar memori sedang digunakan, pengumpul sampah dapat memilih untuk mengumpulkan dari beberapa generasi untuk meningkatkan jumlah memori yang berpotensi tersedia.

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