Fungsi GetPhysicallyInstalledSystemMemory (sysinfoapi.h)

  • Artikel

Mengambil jumlah RAM yang diinstal secara fisik di komputer.

Sintaks

BOOL GetPhysicallyInstalledSystemMemory(
  [out] PULONGLONG TotalMemoryInKilobytes
);

Parameter

[out] TotalMemoryInKilobytes

Penunjuk ke variabel yang menerima jumlah RAM yang diinstal secara fisik, dalam kilobyte.

Mengembalikan nilai

Jika fungsi berhasil, fungsi mengembalikan TRUE dan mengatur parameter TotalMemoryInKilobytes ke nilai bukan nol.

Jika fungsi gagal, fungsi mengembalikan FALSE dan tidak mengubah parameter TotalMemoryInKilobytes . Untuk mendapatkan informasi kesalahan yang diperluas, gunakan fungsi GetLastError . Kesalahan umum tercantum dalam tabel berikut.

Menampilkan kode Deskripsi
ERROR_INVALID_PARAMETER
 Parameter TotalMemoryInKilobytes adalah NULL.
ERROR_INVALID_DATA
 Data BIOS Manajemen Sistem (SMBIOS) salah bentuk.

Keterangan

Fungsi GetPhysicallyInstalledSystemMemory mengambil jumlah RAM yang diinstal secara fisik dari tabel firmware SMBIOS komputer. Ini dapat berbeda dari jumlah yang dilaporkan oleh fungsi GlobalMemoryStatusEx , yang menetapkan anggota ullTotalPhys dari struktur MEMORYSTATUSEX ke jumlah memori fisik yang tersedia untuk digunakan sistem operasi. Jumlah memori yang tersedia untuk sistem operasi dapat kurang dari jumlah memori yang diinstal secara fisik di komputer karena BIOS dan beberapa driver dapat mencadangkan memori sebagai wilayah I/O untuk perangkat yang dipetakan memori, membuat memori tidak tersedia untuk sistem operasi dan aplikasi.

Jumlah memori fisik yang diambil oleh fungsi GetPhysicallyInstalledSystemMemory harus sama dengan atau lebih besar dari jumlah yang dilaporkan oleh fungsi GlobalMemoryStatusEx ; jika kurang, data SMBIOS salah format dan fungsi gagal dengan ERROR_INVALID_DATA. Data SMBIOS yang salah bentuk mungkin menunjukkan masalah dengan komputer pengguna.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows Vista dengan SP1 [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2008 [hanya aplikasi desktop]
Target Platform Windows
Header sysinfoapi.h (sertakan Windows.h)
Pustaka Kernel32.lib
DLL Kernel32.dll

Lihat juga

EnumSystemFirmwareTables

GetSystemFirmwareTable

GlobalMemoryStatusEx