Texas Instruments TI89 Developer Guide - Page 888

846 Appendix A: System Routines - Memory Management HeapAllocHigh Declaration: HANDLE HeapAllocHigh (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, H_NULL if not enough memory. 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. Availability: All versions of the TI-89 / TI-92 Plus. TI-89 / TI-92 Plus Differences: None See Also: HeapAlloc, HeapDeref, HeapFree Example: HANDLE hPermament; SYS_STRUCT *pSysStruct; if (hPermament = HeapAllocHigh(500)) { /* hPermament is the handle to a block of memory that is needed through-out the life of this app and must be kept locked at all times */ pSysStruct = HeapDeref( hPermament ); /* pSysStruct is always valid pSysStruct is used here . . . */ HeapFree( hPermament ); } TI-89 / TI-92 Plus Developer Guide Not for Distribution Beta Version January 26, 2001