Classe CLocalHeap

Questa classe implementa IAtlMemMgr usando le funzioni heap locali Win32.

Importante

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

Sintassi

class CLocalHeap : public IAtlMemMgr

Membri

Metodi pubblici

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

Osservazioni:

CLocalHeap implementa le funzioni di allocazione della memoria usando le funzioni heap locali Win32.

Nota

Le funzioni heap locali 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 .

Esempio

Vedere l'esempio per IAtlMemMgr.

Gerarchia di ereditarietà

IAtlMemMgr

CLocalHeap

Requisiti

Intestazione: atlmem.h

CLocalHeap::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 CLocalHeap::Free o CLocalHeap::Reallocate per liberare la memoria allocata da questo metodo.

Implementato usando LocalAlloc con un parametro flag di LMEM_FIXED.

CLocalHeap::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 LocalFree.

CLocalHeap::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 con LocalSize.

CLocalHeap::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 CLocalHeap::Free per liberare la memoria allocata da questo metodo.

Implementato tramite LocalReAlloc.

Vedi anche

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