GlobalMemoryStatus, fonction (winbase.h)

  • Article

[GlobalMemoryStatus peut retourner des informations incorrectes. Utilisez plutôt la fonction GlobalMemoryStatusEx .]

Récupère des informations sur l’utilisation actuelle de la mémoire physique et virtuelle par le système.

Syntaxe

void GlobalMemoryStatus(
  [out] LPMEMORYSTATUS lpBuffer
);

Paramètres

[out] lpBuffer

Pointeur vers une structure MEMORYSTATUS . La fonction GlobalMemoryStatus stocke des informations sur la disponibilité de la mémoire actuelle dans cette structure.

Valeur de retour

None

Remarques

Sur les ordinateurs avec plus de 4 Go de mémoire, la fonction GlobalMemoryStatus peut retourner des informations incorrectes, en signalant une valeur de –1 pour indiquer un dépassement de capacité. Pour cette raison, les applications doivent utiliser la fonction GlobalMemoryStatusEx à la place.

Sur les ordinateurs Intel x86 avec plus de 2 Go et moins de 4 Go de mémoire, la fonction GlobalMemoryStatus retourne toujours 2 Go dans le membre dwTotalPhys de la structure MEMORYSTATUS . De même, si la mémoire totale disponible est comprise entre 2 et 4 Go, le membre dwAvailPhys de la structure MEMORYSTATUS est arrondi à 2 Go. Si l’exécutable est lié à l’aide de l’option de l’éditeur de liens /LARGEADDRESSAWARE , la fonction GlobalMemoryStatus retourne la quantité correcte de mémoire physique dans les deux membres.

Les informations retournées par la fonction GlobalMemoryStatus sont volatiles. Il n’existe aucune garantie que deux appels séquentiels à cette fonction retournent les mêmes informations.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête winbase.h (inclure Windows.h)
Bibliothèque Kernel32.lib
DLL Kernel32.dll

Voir aussi

GlobalMemoryStatusEx

MEMORYSTATUS

Fonctions de gestion de la mémoire

Informations sur les performances de la mémoire

Espace d’adressage virtuel et stockage physique