Classe CGlobalHeap

Essa classe implementa IAtlMemMgr usando as funções de heap globais do Win32.

Importante

Essa classe e os respectivos membros não podem ser usados em aplicativos executados no Windows Runtime.

Sintaxe

class CGlobalHeap : public IAtlMemMgr

Membros

Métodos públicos

Nome	Descrição
CGlobalHeap::Allocate	Chame esse método para alocar um bloco de memória.
CGlobalHeap::Free	Chame esse método para liberar um bloco de memória alocado por esse gerenciador de memória.
CGlobalHeap::GetSize	Chame esse método para ter o tamanho alocado de um bloco de memória alocado por esse gerenciador de memória.
CGlobalHeap::Reallocate	Chame esse método para realocar a memória alocada por esse gerenciador de memória.

Comentários

CGlobalHeap implementa funções de alocação de memória usando as funções de heap globais do Win32.

Observação

As funções de heap globais 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. As funções globais ainda são usadas pelo DDE e pelas funções da área de transferência.

Exemplo

Consulte o exemplo de IAtlMemMgr.

Hierarquia de herança

IAtlMemMgr

CGlobalHeap

Requisitos

Cabeçalho: atlmem.h

CGlobalHeap::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 Devolução

Retorna um ponteiro para o início do bloco de memória recém-alocado.

Comentários

Chame CGlobalHeap::Free ou CGlobalHeap::Reallocate para liberar a memória alocada por esse método.

Implementado usando GlobalAlloc com um parâmetro de sinalizador de GMEM_FIXED.

CGlobalHeap::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 GlobalFree.

CGlobalHeap::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 Devolução

Retorna o tamanho do bloco de memória alocado em bytes.

Comentários

Implementado usando GlobalSize.

CGlobalHeap::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 Devolução

Retorna um ponteiro para o início do bloco de memória recém-alocado.

Comentários

Chame CGlobalHeap::Free para liberar a memória alocada por esse método.

Implementado usando GlobalReAlloc.

Confira também

Visão geral da classe
Classe CComHeap
Classe CWin32Heap
Classe CLocalHeap
Classe de CCRTHeap
Classe IAtlMemMgr