GlobalMemoryStatus 함수(winbase.h)
[GlobalMemoryStatus 는 잘못된 정보를 반환할 수 있습니다. 대신 GlobalMemoryStatusEx 함수를 사용합니다.]
물리적 메모리와 가상 메모리 모두에 대한 시스템의 현재 사용량에 대한 정보를 검색합니다.
구문
void GlobalMemoryStatus(
[out] LPMEMORYSTATUS lpBuffer
);
매개 변수
[out] lpBuffer
MEMORYSTATUS 구조체에 대한 포인터입니다. GlobalMemoryStatus 함수는 현재 메모리 가용성에 대한 정보를 이 구조에 저장합니다.
반환 값
없음
설명
메모리가 4GB를 초과하는 컴퓨터에서 GlobalMemoryStatus 함수는 잘못된 정보를 반환하여 오버플로를 나타내기 위해 –1 값을 보고할 수 있습니다. 이러한 이유로 애플리케이션은 GlobalMemoryStatusEx 함수를 대신 사용해야 합니다.
메모리가 2GB 이상이고 메모리가 4GB 미만인 Intel x86 컴퓨터에서 GlobalMemoryStatus 함수는 MEMORYSTATUS 구조의 dwTotalPhys 멤버에서 항상 2GB를 반환합니다. 마찬가지로 사용 가능한 총 메모리가 2~4GB인 경우 MEMORYSTATUS 구조의 dwAvailPhys 멤버는 2GB로 반올림됩니다. 실행 파일이 /LARGEADDRESSAWARE 링커 옵션을 사용하여 연결된 경우 GlobalMemoryStatus 함수는 두 멤버 모두에 올바른 양의 실제 메모리를 반환합니다.
GlobalMemoryStatus 함수에서 반환되는 정보는 휘발성입니다. 이 함수에 대한 두 개의 순차 호출이 동일한 정보를 반환한다는 보장은 없습니다.
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows XP [데스크톱 앱만 해당] |
지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
대상 플랫폼 | Windows |
헤더 | winbase.h(Windows.h 포함) |
라이브러리 | Kernel32.lib |
DLL | Kernel32.dll |