Classe CGlobalHeap

Questa classe implementa IAtlMemMgr usando le funzioni heap globali Win32.

Importante

Questa classe e i relativi membri non possono essere usati nelle applicazioni eseguite in Windows Runtime.

Sintassi

class CGlobalHeap : public IAtlMemMgr

Membri

Metodi pubblici

Nome	Descrizione
CGlobalHeap::Allocate	Chiamare questo metodo per allocare un blocco di memoria.
CGlobalHeap::Free	Chiamare questo metodo per liberare un blocco di memoria allocato da questo gestore di memoria.
CGlobalHeap::GetSize	Chiamare questo metodo per ottenere le dimensioni allocate di un blocco di memoria allocato da questo gestore di memoria.
CGlobalHeap::Reallocate	Chiamare questo metodo per riallocare la memoria allocata da questo gestore di memoria.

Osservazioni:

CGlobalHeap implementa funzioni di allocazione della memoria usando le funzioni heap globali Win32.

Nota

Le funzioni heap globali sono più lente rispetto ad altre funzioni di gestione della memoria e non forniscono tutte le funzionalità. Pertanto, le nuove applicazioni devono usare le funzioni heap. Questi sono disponibili nella classe CWin32Heap . Le funzioni globali vengono ancora usate da DDE e dalle funzioni degli Appunti.

Esempio

Vedere l'esempio per IAtlMemMgr.

Gerarchia di ereditarietà

IAtlMemMgr

CGlobalHeap

Requisiti

Intestazione: atlmem.h

CGlobalHeap::Allocate

Chiamare questo metodo per allocare un blocco di memoria.

virtual __declspec(allocator) void* Allocate(size_t nBytes) throw();

Parametri

nBytes
Numero di byte necessari nel nuovo blocco di memoria.

Valore restituito

Restituisce un puntatore all'inizio del blocco di memoria allocata.

Osservazioni:

Chiamare CGlobalHeap::Free o CGlobalHeap::Reallocate per liberare la memoria allocata da questo metodo.

Implementato usando GlobalAlloc con un parametro flag di GMEM_FIXED.

CGlobalHeap::Free

Chiamare questo metodo per liberare un blocco di memoria allocato da questo gestore di memoria.

virtual void Free(void* p) throw();

Parametri

p
Puntatore alla memoria precedentemente allocata dal gestore di memoria. NULL è un valore valido e non esegue alcuna operazione.

Osservazioni:

Implementato tramite GlobalFree.

CGlobalHeap::GetSize

Chiamare questo metodo per ottenere le dimensioni allocate di un blocco di memoria allocato da questo gestore di memoria.

virtual size_t GetSize(void* p) throw();

Parametri

p
Puntatore alla memoria precedentemente allocata dal gestore di memoria.

Valore restituito

Restituisce le dimensioni del blocco di memoria allocato in byte.

Osservazioni:

Implementato tramite GlobalSize.

CGlobalHeap::Reallocate

Chiamare questo metodo per riallocare la memoria allocata da questo gestore di memoria.

virtual __declspec(allocator) void* Reallocate(void* p, size_t nBytes) throw();

Parametri

p
Puntatore alla memoria precedentemente allocata dal gestore di memoria.

nBytes
Numero di byte necessari nel nuovo blocco di memoria.

Valore restituito

Restituisce un puntatore all'inizio del blocco di memoria allocata.

Osservazioni:

Chiamare CGlobalHeap::Free per liberare la memoria allocata da questo metodo.

Implementato tramite GlobalReAlloc.

Vedi anche

Cenni preliminari sulla classe
Classe CComHeap
Classe CWin32Heap
Classe CLocalHeap
Classe CCRTHeap
Classe IAtlMemMgr