Funzione GlobalMemoryStatus (winbase.h)

[GlobalMemoryStatus può restituire informazioni non corrette. Usare invece la funzione GlobalMemoryStatusEx .]

Recupera informazioni sull'utilizzo corrente del sistema sia della memoria fisica che virtuale.

Sintassi

void GlobalMemoryStatus(
  [out] LPMEMORYSTATUS lpBuffer
);

Parametri

[out] lpBuffer

Puntatore a una struttura MEMORYSTATUS . La funzione GlobalMemoryStatus archivia informazioni sulla disponibilità della memoria corrente in questa struttura.

Valore restituito

nessuno

Osservazioni

Nei computer con più di 4 GB di memoria, la funzione GlobalMemoryStatus può restituire informazioni non corrette, segnalando un valore -1 per indicare un overflow. Per questo motivo, le applicazioni devono usare invece la funzione GlobalMemoryStatusEx .

Nei computer Intel x86 con più di 2 GB e meno di 4 GB di memoria, la funzione GlobalMemoryStatus restituirà sempre 2 GB nel membro dwTotalPhys della struttura MEMORYSTATUS . Analogamente, se la memoria totale disponibile è compresa tra 2 e 4 GB, il membro dwAvailPhys della struttura MEMORYSTATUS verrà arrotondato a 2 GB. Se l'eseguibile è collegato usando l'opzione del linker /LARGEADDRESSAWARE , la funzione GlobalMemoryStatus restituirà la quantità corretta di memoria fisica in entrambi i membri.

Le informazioni restituite dalla funzione GlobalMemoryStatus sono volatili. Non esiste alcuna garanzia che due chiamate sequenziali a questa funzione restituiranno le stesse informazioni.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winbase.h (include Windows.h)
Libreria	Kernel32.lib
DLL	Kernel32.dll

Vedere anche

GlobalMemoryStatusEx

MEMORYSTATUS

Funzioni di gestione della memoria

Informazioni sulle prestazioni della memoria

Spazio indirizzi virtuali e archiviazione fisica