Fungsi CreateMemoryResourceNotification (memoryapi.h)

  • Artikel

Membuat objek pemberitahuan sumber daya memori.

Sintaks

HANDLE CreateMemoryResourceNotification(
  [in] MEMORY_RESOURCE_NOTIFICATION_TYPE NotificationType
);

Parameter

[in] NotificationType

Kondisi memori tempat objek akan diberi sinyal. Parameter ini bisa menjadi salah satu nilai berikut dari enumerasi MEMORY_RESOURCE_NOTIFICATION_TYPE .

Nilai Makna
LowMemoryResourceNotification
0
 Memori fisik yang tersedia hampir habis.
HighMemoryResourceNotification
1
 Memori fisik yang tersedia tinggi.

Menampilkan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah handel ke objek pemberitahuan sumber daya memori.

Jika fungsi gagal, nilai yang dikembalikan adalah NULL. Untuk mendapatkan informasi yang diperluas, hubungi GetLastError.

Keterangan

Aplikasi dapat menggunakan peristiwa pemberitahuan sumber daya memori untuk menskalakan penggunaan memori yang sesuai. Jika memori yang tersedia rendah, aplikasi dapat mengurangi set kerjanya. Jika memori yang tersedia tinggi, aplikasi dapat mengalokasikan lebih banyak memori.

Setiap utas proses panggilan dapat menentukan handel pemberitahuan sumber daya memori dalam panggilan ke fungsi QueryMemoryResourceNotification atau salah satu fungsi tunggu. Status objek disinyalkan ketika kondisi memori yang ditentukan ada. Ini adalah peristiwa di seluruh sistem, sehingga semua aplikasi menerima pemberitahuan ketika objek disinyalkan. Perhatikan bahwa ada berbagai ketersediaan memori di mana objek LowMemoryResourceNotification atau HighMemoryResourceNotification tidak diberi sinyal. Dalam hal ini, aplikasi harus mencoba menjaga penggunaan memori tetap konstan.

Gunakan fungsi CloseHandle untuk menutup handel. Sistem menutup handel secara otomatis ketika proses berakhir. Objek pemberitahuan sumber daya memori dihancurkan ketika handel terakhirnya telah ditutup.

Untuk mengkompilasi aplikasi yang menggunakan fungsi ini, tentukan makro _WIN32_WINNT sebagai 0x0501 atau yang lebih baru. Untuk informasi selengkapnya, lihat Menggunakan Header Windows.

Persyaratan

   
Klien minimum yang didukung Windows XP [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Target Platform Windows
Header memoryapi.h (termasuk Windows.h, Memoryapi.h)
Pustaka onecore.lib
DLL Kernel32.dll

Lihat juga

CloseHandle

Fungsi Manajemen Memori

QueryMemoryResourceNotification