Fungsi GlobalMemoryStatus (winbase.h)

Artikel
03/03/2024

[GlobalMemoryStatus dapat mengembalikan informasi yang salah. Gunakan fungsi GlobalMemoryStatusEx sebagai gantinya.]

Mengambil informasi tentang penggunaan memori fisik dan virtual sistem saat ini.

Sintaks

void GlobalMemoryStatus(
  [out] LPMEMORYSTATUS lpBuffer
);

Parameter

[out] lpBuffer

Penunjuk ke struktur MEMORYSTATUS . Fungsi GlobalMemoryStatus menyimpan informasi tentang ketersediaan memori saat ini ke dalam struktur ini.

Mengembalikan nilai

Tidak ada

Keterangan

Pada komputer dengan memori lebih dari 4 GB, fungsi GlobalMemoryStatus dapat mengembalikan informasi yang salah, melaporkan nilai -1 untuk menunjukkan luapan. Untuk alasan ini, aplikasi harus menggunakan fungsi GlobalMemoryStatusEx sebagai gantinya.

Pada komputer Intel x86 dengan lebih dari 2 GB dan memori kurang dari 4 GB, fungsi GlobalMemoryStatus akan selalu mengembalikan 2 GB di anggota dwTotalPhys dari struktur MEMORYSTATUS . Demikian pula, jika total memori yang tersedia adalah antara 2 dan 4 GB, anggota dwAvailPhys dari struktur MEMORYSTATUS akan dibulatkan ke bawah hingga 2 GB. Jika executable ditautkan menggunakan opsi linker /LARGEADDRESSAWARE , maka fungsi GlobalMemoryStatus akan mengembalikan jumlah memori fisik yang benar di kedua anggota.

Informasi yang dikembalikan oleh fungsi GlobalMemoryStatus volatil. Tidak ada jaminan bahwa dua panggilan berurutan ke fungsi ini akan mengembalikan informasi yang sama.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	winbase.h (termasuk Windows.h)
Pustaka	Kernel32.lib
DLL	Kernel32.dll