Heapderef - Texas Instruments TI-89 Developer's Manual

Appendix A: System Routines — Memory Management

HeapDeref

Declaration: void * HeapDeref (HANDLE h )
Category(ies): Memory Management
Description: Dereferences a HANDLE and returns a pointer to the block of memory
defined by that handle. The heap allocation routines return a HANDLE
which is an identifier for a block of memory allocated in the heap. In order
to use that memory, the handle must be dereferenced. Once a handle is
dereferenced, that pointer is valid as long as nothing else is done to cause
the heap to be compressed. If the heap is compressed the handle can be
redereferenced to make it valid again. If a HANDLE is locked, then the
pointer that references that block of memory is valid even after the heap is
compressed (since locking a handle means the heap manager will never
move the memory associated with that handle).
Inputs: h — Handle created with a heap allocation routine like HeapAlloc or
Outputs: Pointer to the block of memory defined by the given handle.
Assumptions: None
Side Effects: None
Availability: All versions of the TI-89 / TI-92 Plus.
TI-89 / TI-92 Plus
Differences: None
See Also: HeapAlloc, HeapAllocHigh, HeapAllocThrow, HeapAllocHighThrow,
HeapLock, HeapUnlock, HeapFree, HeapFreeIndir
Example: See HeapAlloc.
TI-89 / TI-92 Plus Developer Guide
HeapAllocThrow.
Not for Distribution
851
Beta Version January 26, 2001