Freigeben über


GlobalMemoryStatus-Funktion (winbase.h)

[GlobalMemoryStatus kann falsche Informationen zurückgeben. Verwenden Sie stattdessen die GlobalMemoryStatusEx-Funktion .]

Ruft Informationen zur aktuellen Systemauslastung sowohl des physischen als auch des virtuellen Speichers ab.

Syntax

void GlobalMemoryStatus(
  [out] LPMEMORYSTATUS lpBuffer
);

Parameter

[out] lpBuffer

Ein Zeiger auf eine MEMORYSTATUS-Struktur . Die Funktion GlobalMemoryStatus speichert Informationen zur aktuellen Speicherverfügbarkeit in dieser Struktur.

Rückgabewert

Keine

Bemerkungen

Auf Computern mit mehr als 4 GB Arbeitsspeicher kann die Funktion GlobalMemoryStatus falsche Informationen zurückgeben und den Wert –1 angeben, um einen Überlauf anzuzeigen. Aus diesem Grund sollten Anwendungen stattdessen die Funktion GlobalMemoryStatusEx verwenden.

Auf Intel x86-Computern mit mehr als 2 GB und weniger als 4 GB Arbeitsspeicher gibt die GlobalMemoryStatus-Funktion immer 2 GB im dwTotalPhys-Element der MEMORYSTATUS-Struktur zurück. Wenn der gesamte verfügbare Arbeitsspeicher zwischen 2 und 4 GB liegt, wird der dwAvailPhys-Member der MEMORYSTATUS-Struktur auf 2 GB gerundet. Wenn die ausführbare Datei mit der Linkeroption /LARGEADDRESSAWARE verknüpft ist, gibt die GlobalMemoryStatus-Funktion die richtige Menge an physischem Arbeitsspeicher in beiden Membern zurück.

Die von der GlobalMemoryStatus-Funktion zurückgegebenen Informationen sind flüchtig. Es gibt keine Garantie, dass zwei sequenzielle Aufrufe dieser Funktion dieselben Informationen zurückgeben.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile winbase.h (Windows.h einschließen)
Bibliothek Kernel32.lib
DLL Kernel32.dll

Siehe auch

GlobalMemoryStatusEx

MEMORYSTATUS

Speicherverwaltungsfunktionen

Speicherleistungsinformationen

Virtueller Adressraum und physischer Speicher