Appendix A: System Routines — Memory Management
851
TI
-
89 / TI
-
92 Plus Developer Guide
Not for Distribution
Beta Version January 26, 2001
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
HeapAllocThrow
.
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
.
To Next Page
Loading...
Need help?
General
