Classe CLocalHeap
Essa classe implementa IAtlMemMgr usando as funções de heap local do Win32.
Importante
Essa classe e seus membros não podem ser usados em aplicativos que são executados no Windows Runtime.
Sintaxe
class CLocalHeap : public IAtlMemMgr
Membros
Métodos públicos
| Nome | Descrição |
|---|---|
| CLocalHeap:: Allocate | Chame esse método para alocar um bloco de memória. |
| CLocalHeap:: Free | Chame esse método para liberar um bloco de memória alocado por esse Gerenciador de memória. |
| CLocalHeap::GetSize | Chame esse método para obter o tamanho alocado de um bloco de memória alocado por esse Gerenciador de memória. |
| CLocalHeap:: realocar | Chame esse método para realocar memória alocada por esse Gerenciador de memória. |
Comentários
CLocalHeap implementa as funções de alocação de memória usando as funções de heap local do Win32.
Observação
As funções de heap local são mais lentas do que outras funções de gerenciamento de memória e não fornecem quantos recursos. Portanto, novos aplicativos devem usar as funções de heap. Eles estão disponíveis na classe CWin32Heap .
Exemplo
Consulte o exemplo de IAtlMemMgr.
Hierarquia de herança
IAtlMemMgr
CLocalHeap
Requisitos
Cabeçalho: atlmem. h
CLocalHeap:: Allocate
Chame esse método para alocar um bloco de memória.
virtual __declspec(allocator) void* Allocate(size_t nBytes) throw();
Parâmetros
nBytes
O número de bytes solicitado no novo bloco de memória.
Valor Retornado
Retorna um ponteiro para o início do bloco de memória alocado recentemente.
Comentários
Chame CLocalHeap:: Free ou CLocalHeap:: realoque para liberar a memória alocada por esse método.
Implementado usando LocalAlloc com um parâmetro de sinalizador de LMEM_FIXED.
CLocalHeap:: Free
Chame esse método para liberar um bloco de memória alocado por esse Gerenciador de memória.
virtual void Free(void* p) throw();
Parâmetros
DTI
Ponteiro para a memória alocada anteriormente por esse Gerenciador de memória. NULL é um valor válido e não faz nada.
Comentários
Implementado usando LocalFree.
CLocalHeap::GetSize
Chame esse método para obter o tamanho alocado de um bloco de memória alocado por esse Gerenciador de memória.
virtual size_t GetSize(void* p) throw();
Parâmetros
DTI
Ponteiro para a memória alocada anteriormente por esse Gerenciador de memória.
Valor Retornado
Retorna o tamanho do bloco de memória alocado em bytes.
Comentários
Implementado usando o Localize.
CLocalHeap:: realocar
Chame esse método para realocar memória alocada por esse Gerenciador de memória.
virtual __declspec(allocator) void* Reallocate(void* p, size_t nBytes) throw();
Parâmetros
DTI
Ponteiro para a memória alocada anteriormente por esse Gerenciador de memória.
nBytes
O número de bytes solicitado no novo bloco de memória.
Valor Retornado
Retorna um ponteiro para o início do bloco de memória alocado recentemente.
Comentários
Chame CLocalHeap:: Free para liberar a memória alocada por este método.
Implementado usando LocalReAlloc.
Confira também
Visão geral da classe
Classe CComHeap
Classe CWin32Heap
Classe CGlobalHeap
Classe CCRTHeap
Classe IAtlMemMgr