Fungsi QueryMemoryResourceNotification (memoryapi.h)

Mengambil status objek sumber daya memori yang ditentukan.

Sintaks

BOOL QueryMemoryResourceNotification(
  [in]  HANDLE ResourceNotificationHandle,
  [out] PBOOL  ResourceState
);

Parameter

[in] ResourceNotificationHandle

Handel ke objek pemberitahuan sumber daya memori. Fungsi CreateMemoryResourceNotification mengembalikan handel ini.

[out] ResourceState

Memori yang ditujukkan oleh parameter ini menerima status objek pemberitahuan sumber daya memori. Nilai parameter ini diatur ke TRUE jika kondisi memori yang ditentukan ada, dan FALSE jika kondisi memori yang ditentukan tidak ada.

Menampilkan nilai

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk informasi kesalahan lainnya, hubungi GetLastError.

Keterangan

Tidak seperti fungsi tunggu, QueryMemoryResourceNotification tidak memblokir utas panggilan. Oleh karena itu, ini adalah cara yang efisien untuk memeriksa keadaan memori fisik sebelum melanjutkan operasi.

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

CreateMemoryResourceNotification

Fungsi Manajemen Memori