Функция 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 |