Класс CGlobalHeap

Этот класс реализует IAtlMemMgr с помощью функций глобальной кучи Win32.

Важно!

Этот класс и его члены нельзя использовать в приложениях, выполняемых в среде выполнения Windows.

Синтаксис

class CGlobalHeap : public IAtlMemMgr

Участники

Открытые методы

Имя	Описание
CGlobalHeap::Allocate	Вызовите этот метод, чтобы выделить блок памяти.
CGlobalHeap::Free	Вызовите этот метод, чтобы освободить блок памяти, выделенный этим диспетчером памяти.
CGlobalHeap::GetSize	Вызовите этот метод, чтобы получить выделенный размер блока памяти, выделенного этим диспетчером памяти.
CGlobalHeap::Reallocate	Вызовите этот метод для перераспределения памяти, выделенной данным диспетчером памяти.

Замечания

CGlobalHeap реализует функции выделения памяти с помощью глобальных функций кучи Win32.

Примечание.

Глобальные функции кучи медленнее других функций управления памятью и не предоставляют столько функций. Поэтому новые приложения должны использовать функции кучи. Они доступны в классе CWin32Heap . Глобальные функции по-прежнему используются DDE и функциями буфера обмена.

Пример

См. пример для IAtlMemMgr.

Иерархия наследования

IAtlMemMgr

CGlobalHeap

Требования

Заголовок: atlmem.h

CGlobalHeap::Allocate

Вызовите этот метод, чтобы выделить блок памяти.

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

Параметры

nBytes
Запрошенное число байтов в новом блоке памяти.

Возвращаемое значение

Возвращает указатель на начало выделенного блока памяти.

Замечания

Вызовите CGlobalHeap::Free или CGlobalHeap::Reallocate , чтобы освободить память, выделенную этим методом.

Реализовано с помощью GlobalAlloc с параметром флага GMEM_FIXED.

CGlobalHeap::Free

Вызовите этот метод, чтобы освободить блок памяти, выделенный этим диспетчером памяти.

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

Параметры

p
Указатель на область памяти, выделенную ранее данным диспетчером памяти. NULL является допустимым значением и ничего не делает.

Замечания

Реализовано с помощью GlobalFree.

CGlobalHeap::GetSize

Вызовите этот метод, чтобы получить выделенный размер блока памяти, выделенного этим диспетчером памяти.

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

Параметры

p
Указатель на область памяти, выделенную ранее данным диспетчером памяти.

Возвращаемое значение

Возвращает размер выделенного блока памяти в байтах.

Замечания

Реализовано с помощью GlobalSize.

CGlobalHeap::Reallocate

Вызовите этот метод для перераспределения памяти, выделенной данным диспетчером памяти.

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

Параметры

p
Указатель на область памяти, выделенную ранее данным диспетчером памяти.

nBytes
Запрошенное число байтов в новом блоке памяти.

Возвращаемое значение

Возвращает указатель на начало выделенного блока памяти.

Замечания

Вызовите CGlobalHeap::Free , чтобы освободить память, выделенную этим методом.

Реализовано с помощью GlobalReAlloc.

См. также

Общие сведения о классе
Класс CComHeap
Класс CWin32Heap
Класс CLocalHeap
Класс CCRTHeap
Класс IAtlMemMgr