Fungsi QueryMemoryResourceNotification (memoryapi.h)

  • Artikel

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