GlobalMemoryStatus 함수(winbase.h)

아티클
03/08/2023

[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