Функция GlobalMemoryStatus (winbase.h)

  • Статья

[GlobalMemoryStatus может возвращать неверные сведения. Вместо этого используйте функцию GlobalMemoryStatusEx .]

Извлекает сведения о текущем использовании системой физической и виртуальной памяти.

Синтаксис

void GlobalMemoryStatus(
  [out] LPMEMORYSTATUS lpBuffer
);

Параметры

[out] lpBuffer

Указатель на структуру MEMORYSTATUS . Функция GlobalMemoryStatus сохраняет сведения о текущей доступности памяти в этой структуре.

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

None

Remarks

На компьютерах с объемом памяти более 4 ГБ функция GlobalMemoryStatus может возвращать неверные сведения, сообщая значение –1, указывающее на переполнение. По этой причине приложения должны использовать функцию GlobalMemoryStatusEx .

На компьютерах Intel x86 с объемом памяти более 2 ГБ и менее 4 ГБ памяти функция GlobalMemoryStatus всегда возвращает 2 ГБ в элементе dwTotalPhys структуры MEMORYSTATUS . Аналогичным образом, если общий объем доступной памяти составляет от 2 до 4 ГБ, член dwAvailPhys структуры MEMORYSTATUS будет округлен до 2 ГБ. Если исполняемый файл связан с помощью параметра компоновщика /LARGEADDRESSAWARE , функция GlobalMemoryStatus вернет правильный объем физической памяти в обоих членах.

Сведения, возвращаемые функцией GlobalMemoryStatus , являются переменными. Нет никакой гарантии, что два последовательных вызова этой функции будут возвращать одни и те же сведения.

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header winbase.h (включая Windows.h)
Библиотека Kernel32.lib
DLL Kernel32.dll

См. также

GlobalMemoryStatusEx

MEMORYSTATUS

Функции управления памятью

Сведения о производительности памяти

Виртуальное адресное пространство и физическое хранилище