Función GlobalMemoryStatus (winbase.h)

Artículo
03/03/2024

[GlobalMemoryStatus puede devolver información incorrecta. Use la función GlobalMemoryStatusEx en su lugar.]

Recupera información sobre el uso actual del sistema de memoria física y virtual.

Sintaxis

void GlobalMemoryStatus(
  [out] LPMEMORYSTATUS lpBuffer
);

Parámetros

[out] lpBuffer

Puntero a una estructura MEMORYSTATUS . La función GlobalMemoryStatus almacena información sobre la disponibilidad de memoria actual en esta estructura.

Valor devuelto

None

Observaciones

En equipos con más de 4 GB de memoria, la función GlobalMemoryStatus puede devolver información incorrecta, informando de un valor de –1 para indicar un desbordamiento. Por este motivo, las aplicaciones deben usar la función GlobalMemoryStatusEx en su lugar.

En equipos Intel x86 con más de 2 GB y menos de 4 GB de memoria, la función GlobalMemoryStatus siempre devolverá 2 GB en el miembro dwTotalPhys de la estructura MEMORYSTATUS . Del mismo modo, si la memoria total disponible está entre 2 y 4 GB, el miembro dwAvailPhys de la estructura MEMORYSTATUS se redondeará a 2 GB. Si el ejecutable está vinculado mediante la opción del enlazador /LARGEADDRESSAWARE , la función GlobalMemoryStatus devolverá la cantidad correcta de memoria física en ambos miembros.

La información devuelta por la función GlobalMemoryStatus es volátil. No hay ninguna garantía de que dos llamadas secuenciales a esta función devuelvan la misma información.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winbase.h (incluya Windows.h)
Library	Kernel32.lib
Archivo DLL	Kernel32.dll