CGlobalHeap, classe
Cette classe implémente IAtlMemMgr à l’aide des fonctions de tas globales Win32.
Important
Cette classe et ses membres ne peuvent pas être utilisés dans les applications qui s’exécutent dans Windows Runtime.
Syntaxe
class CGlobalHeap : public IAtlMemMgr
Membres
Méthodes publiques
| Nom | Description |
|---|---|
| CGlobalHeap ::Allocate | Appelez cette méthode pour allouer un bloc de mémoire. |
| CGlobalHeap ::Free | Appelez cette méthode pour libérer un bloc de mémoire alloué par ce gestionnaire de mémoire. |
| CGlobalHeap ::GetSize | Appelez cette méthode pour obtenir la taille allouée d’un bloc de mémoire alloué par ce gestionnaire de mémoire. |
| CGlobalHeap ::Reallocate | Appelez cette méthode pour réallouer la mémoire allouée par ce gestionnaire de mémoire. |
Notes
CGlobalHeap implémente des fonctions d’allocation de mémoire à l’aide des fonctions de tas globales Win32.
Remarque
Les fonctions de tas globales sont plus lentes que d’autres fonctions de gestion de la mémoire et ne fournissent pas autant de fonctionnalités. Par conséquent, les nouvelles applications doivent utiliser les fonctions de tas. Ceux-ci sont disponibles dans la classe CWin32Heap . Les fonctions globales sont toujours utilisées par DDE et les fonctions du Presse-papiers.
Exemple
Consultez l’exemple pour IAtlMemMgr.
Hiérarchie d'héritage
IAtlMemMgr
CGlobalHeap
Spécifications
En-tête : atlmem.h
CGlobalHeap ::Allocate
Appelez cette méthode pour allouer un bloc de mémoire.
virtual __declspec(allocator) void* Allocate(size_t nBytes) throw();
Paramètres
octets
Nombre demandé d'octets dans le nouveau bloc de mémoire.
Valeur de retour
Retourne un pointeur vers le début du bloc de mémoire nouvellement alloué.
Notes
Appelez CGlobalHeap ::Free ou CGlobalHeap ::Reallocate pour libérer la mémoire allouée par cette méthode.
Implémenté à l’aide de GlobalAlloc avec un paramètre d’indicateur de GMEM_FIXED.
CGlobalHeap ::Free
Appelez cette méthode pour libérer un bloc de mémoire alloué par ce gestionnaire de mémoire.
virtual void Free(void* p) throw();
Paramètres
p
Pointeur vers la mémoire précédemment allouée par ce gestionnaire de mémoire. NULL est une valeur valide et ne fait rien.
Notes
Implémenté à l’aide de GlobalFree.
CGlobalHeap ::GetSize
Appelez cette méthode pour obtenir la taille allouée d’un bloc de mémoire alloué par ce gestionnaire de mémoire.
virtual size_t GetSize(void* p) throw();
Paramètres
p
Pointeur vers la mémoire précédemment allouée par ce gestionnaire de mémoire.
Valeur de retour
Retourne la taille du bloc de mémoire alloué en octets.
Notes
Implémenté à l’aide de GlobalSize.
CGlobalHeap ::Reallocate
Appelez cette méthode pour réallouer la mémoire allouée par ce gestionnaire de mémoire.
virtual __declspec(allocator) void* Reallocate(void* p, size_t nBytes) throw();
Paramètres
p
Pointeur vers la mémoire précédemment allouée par ce gestionnaire de mémoire.
octets
Nombre demandé d'octets dans le nouveau bloc de mémoire.
Valeur de retour
Retourne un pointeur vers le début du bloc de mémoire nouvellement alloué.
Notes
Appelez CGlobalHeap ::Free pour libérer la mémoire allouée par cette méthode.
Implémenté à l’aide de GlobalReAlloc.
Voir aussi
Vue d’ensemble de la classe
CComHeap, classe
CWin32Heap, classe
CLocalHeap, classe
CCRTHeap, classe
IAtlMemMgr, classe