Texas Instruments TI89 Developer Guide - Page 889

Appendix A: System Routines - Memory Management 847 HeapAllocHighThrow Declaration: HANDLE HeapAllocHighThrow (DWORD Hlen) Category(ies): Memory Management Description: Allocate a block of heap memory at the high end of the heap, lock it and return its handle. This routine should NOT be used as a general heap allocation routine. It also compresses the heap first to (hopefully) move all used (unlocked) blocks of memory down. Blocks of memory that are locked for long periods of time should be moved high in memory so that they do not interfere as much with rest of the system. Inputs: Hlen - Length of block of memory to allocate (all odd sizes are rounded up to be even). Outputs: HANDLE of memory block allocated, throws an ER_MEMORY error if not enough memory (HeapAllocHigh just returns H_NULL in that case). Assumptions: Hlen may not exceed 65520 bytes and the minimum block size is eight bytes. Side Effects: This routine ALWAYS compresses the heap before it tries to allocate the requested memory and so is much slower than the standard HeapAlloc routine. Locking memory may cause the system to run out of useable memory sooner than if memory is kept unlocked. This routine may throw an ER_MEMORY error. Availability: All versions of the TI-89 / TI-92 Plus. TI-89 / TI-92 Plus Differences: None See Also: HeapAllocHigh, HeapAllocThrow, HeapFree, HeapFreeIndir Example: See HeapAllocThrow substituting HeapAllocHighThrow for HeapAllocThrow. TI-89 / TI-92 Plus Developer Guide Not for Distribution Beta Version January 26, 2001