Classe CLocalHeap
Essa classe implementa IAtlMemMgr usando as funções de heap locais do Win32.
Importante
Essa classe e os respectivos membros não podem ser usados em aplicativos 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 ter o tamanho alocado de um bloco de memória alocado por esse gerenciador de memória. |
| CLocalHeap::Reallocate | Chame esse método para realocar a memória alocada por esse gerenciador de memória. |
Comentários
CLocalHeap implementa funções de alocação de memória usando as funções de heap locais do Win32.
Observação
As funções de heap locais são mais lentas do que outras funções de gerenciamento de memória e não fornecem tantos 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 solicitado de bytes no novo bloco de memória.
Valor de retorno
Retorna um ponteiro para o início do bloco de memória recém-alocado.
Comentários
Chame CLocalHeap::Free ou CLocalHeap::Reallocate 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
p
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 ter 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
p
Ponteiro para a memória alocada anteriormente por esse gerenciador de memória.
Valor de retorno
Retorna o tamanho do bloco de memória alocado em bytes.
Comentários
Implementado usando LocalSize.
CLocalHeap::Reallocate
Chame esse método para realocar a memória alocada por esse gerenciador de memória.
virtual __declspec(allocator) void* Reallocate(void* p, size_t nBytes) throw();
Parâmetros
p
Ponteiro para a memória alocada anteriormente por esse gerenciador de memória.
nBytes
O número solicitado de bytes no novo bloco de memória.
Valor de retorno
Retorna um ponteiro para o início do bloco de memória recém-alocado.
Comentários
Chame CLocalHeap::Free para liberar a memória alocada por esse método.
Implementado usando LocalReAlloc.
Confira também
Visão geral da aula
Classe CComHeap
Classe CWin32Heap
Classe CGlobalHeap
Classe de CCRTHeap
Classe IAtlMemMgr