CCRTHeap Class
The latest version of this topic can be found at CCRTHeap Class.
This class implements IAtlMemMgr using the CRT heap functions.
Syntax
class CCRTHeap : public IAtlMemMgr
Members
Public Methods
| Name | Description |
|---|---|
| CCRTHeap::Allocate | Call this method to allocate a block of memory. |
| CCRTHeap::Free | Call this method to free a block of memory allocated by this memory manager. |
| CCRTHeap::GetSize | Call this method to get the allocated size of a memory block allocated by this memory manager. |
| CCRTHeap::Reallocate | Call this method to reallocate memory allocated by this memory manager. |
Remarks
CCRTHeap implements memory allocation functions using the CRT heap functions, including malloc, free, realloc, and _msize.
Example
See the example for IAtlMemMgr.
Inheritance Hierarchy
IAtlMemMgr
CCRTHeap
Requirements
Header: atlmem.h
CCRTHeap::Allocate
Call this method to allocate a block of memory.
virtual __declspec(allocator) void* Allocate(size_t nBytes) throw();
Parameters
nBytes
The requested number of bytes in the new memory block.
Return Value
Returns a pointer to the start of the newly allocated memory block.
Remarks
Call CCRTHeap::Free or CCRTHeap::Reallocate to free the memory allocated by this method.
Implemented using malloc.
CCRTHeap::Free
Call this method to free a block of memory allocated by this memory manager.
virtual void Free(void* p) throw();
Parameters
p
Pointer to memory previously allocated by this memory manager. NULL is a valid value and does nothing.
Remarks
Implemented using free.
CCRTHeap::GetSize
Call this method to get the allocated size of a memory block allocated by this memory manager.
virtual size_t GetSize(void* p) throw();
Parameters
p
Pointer to memory previously allocated by this memory manager.
Return Value
Returns the size of the allocated memory block in bytes.
Remarks
Implemented using _msize.
CCRTHeap::Reallocate
Call this method to reallocate memory allocated by this memory manager.
virtual __declspec(allocator) void* Reallocate(void* p, size_t nBytes) throw();
Parameters
p
Pointer to memory previously allocated by this memory manager.
nBytes
The requested number of bytes in the new memory block.
Return Value
Returns a pointer to the start of the newly allocated memory block.
Remarks
Call CCRTHeap::Free to free the memory allocated by this method. Implemented using realloc.
See Also
Class Overview
CComHeap Class
CWin32Heap Class
CLocalHeap Class
CGlobalHeap Class
IAtlMemMgr Class