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 |