Функция GetPhysicallyInstalledSystemMemory (sysinfoapi.h)

Извлекает объем ОЗУ, который физически установлен на компьютере.

Синтаксис

BOOL GetPhysicallyInstalledSystemMemory(
  [out] PULONGLONG TotalMemoryInKilobytes
);

Параметры

[out] TotalMemoryInKilobytes

Указатель на переменную, которая получает объем физическо установленной ОЗУ в килобайтах.

Возвращаемое значение

Если функция выполняется успешно, она возвращает значение TRUE и задает для параметра TotalMemoryInKilobytes ненулевое значение.

Если функция завершается сбоем, она возвращает значение FALSE и не изменяет параметр TotalMemoryInKilobytes . Чтобы получить расширенные сведения об ошибке, используйте функцию GetLastError . Распространенные ошибки перечислены в следующей таблице.

Комментарии

Функция GetPhysicallyInstalledSystemMemory извлекает физически установленный объем ОЗУ из таблиц встроенного ПО SMBIOS компьютера. Это может отличаться от объема, сообщаемого функцией GlobalMemoryStatusEx , которая задает член ullTotalPhys структуры MEMORYSTATUSEX объемом физической памяти, доступной операционной системе. Объем памяти, доступный операционной системе, может быть меньше объема памяти, физически установленной на компьютере, так как BIOS и некоторые драйверы могут резервировать память в качестве областей ввода-вывода для устройств, подключенных к памяти, что делает память недоступной для операционной системы и приложений.

Объем физической памяти, получаемой функцией GetPhysicallyInstalledSystemMemory , должен быть равен или больше объема, сообщаемого функцией GlobalMemoryStatusEx ; Если значение меньше, данные SMBIOS неправильно сформированы и функция завершается сбоем с ERROR_INVALID_DATA. Неправильные данные SMBIOS могут указывать на проблему с компьютером пользователя.

Требования

См. также

EnumSystemFirmwareTables

GetSystemFirmwareTable

GlobalMemoryStatusEx