GPL_MemoryManager

gpl

1998 12-05

CLASS

SYNOPSIS

PARENTS

MEMBER FUNCTIONS

virtual unsigned long GetSize(GPL_Address address) = 0
Return the number of bytes allocated for address and 0 otherwise.



virtual void Initialize(void)
Initialize the memory manager.



virtual void Finalize(void)
Finalize the memory manager.



virtual void Defragment(void)
Perform external defragmentation on the blocks of memory managed by the memory manager.



virtual GPL_Boolean Reallocate(const unsigned long size, GPL_Address & address)
Allocate size bytes of memory and place the address of those bytes in address. If the incoming value of address is not GPL_BAD_ADDRESS, the previous contents at address will be copied to the new address. Return TRUE if the allocation succeeded and FALSE otherwise.



virtual GPL_Boolean Deallocate(GPL_Address address)
Deallocate the memory allocated for address. Return TRUE if the deallocation succeeded and FALSE otherwise.



virtual GPL_Boolean StartRead(GPL_Address & address, const unsigned long size)
Ensure that address contains the address of the size bytes at the incoming value of address and acquire a shared lock on address. If the lock is not available, return FALSE immediately. Return TRUE if the lock is acquired and FALSE otherwise.



virtual GPL_Boolean StopRead(GPL_Address address)
Release the shared lock on address. Return TRUE if the lock was released and FALSE otherwise.



virtual GPL_Boolean StartWait(GPL_Address & address, const unsigned long size)
Ensure that address contains the address of the size bytes at the incoming value of address and acquire a shared lock on address, waiting until the lock is available. Return TRUE if the lock is acquired and FALSE otherwise.



virtual GPL_Boolean StopWait(GPL_Address address)
Release the shared lock on address. Return TRUE if the lock was released and FALSE otherwise.



virtual GPL_Boolean StartWrite(GPL_Address & address, const unsigned long size)
Ensure that address contains the address of the size bytes at the incoming value of address and acquire an exclusive lock on address. Return TRUE if address is valid and the lock is acquired and FALSE otherwise.



virtual GPL_Boolean StopWrite(GPL_Address address, const unsigned long size)
Ensure that the size bytes at the incoming value of address are at the address specified by address and release the exclusive lock on address. Return TRUE if address is valid and the lock is released and FALSE otherwise.

SEE ALSO