GlobalMemoryStatus, fonction (winbase.h)
[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
Fonctions de gestion de la mémoire