home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 4 / DATAFILE_PDCD4.iso / utilities / utilsd / evntshell / Docs / Memory < prev    next >
Encoding:
Text File  |  1995-10-03  |  2.6 KB  |  101 lines
  1. PROCshell_HeapBlockReturn()
  2. Params =>  
  3.          int address of heap block
  4.  
  5. Releases the given heap block, returning memory to
  6. the free pool.
  7.  
  8. --------------------------------------------------------
  9.  
  10. PROCshell_HeapBlockInit()
  11. Params =>
  12.          None
  13.  
  14. --------------------------------------------------------
  15.  
  16. FNshell_HeapBlockExtend()
  17. Params =>
  18.          int address of heap block
  19.          int amount to increase or decrease block size by
  20.              (-ve to decrease)
  21.  
  22.        <=
  23.          int address of heap block
  24.  
  25. Increases or decreases the size of the given heap block
  26. which must have been allocated with FNshell_HeapBlockFetch.
  27. Note that the heap block may be moved to make it fit so you
  28. should always use the returned value for the heap block
  29. address after this call.
  30.  
  31. --------------------------------------------------------
  32.  
  33. FNshell_HeapBlockFetch()
  34. Params =>
  35.          int size of block to fetch from heap
  36.  
  37.        <=
  38.          int address of heapblock allocated
  39.  
  40. Returns address of heapblock or causes an "Out
  41. of memory" error if the block cannot be
  42. allocated.
  43.  
  44. --------------------------------------------------------
  45.  
  46. FNshell_HeapBlockInfo()
  47. Params =>
  48.          int address of heap block
  49.  
  50.        <=
  51.          int size of heap block (Note that this
  52.              is larger than the size requested
  53.              with FNshell_HeapBlockFetch)
  54.  
  55. --------------------------------------------------------
  56.  
  57. PROCshell_HeapManagerInit
  58. Params =>
  59.          str path to directory containing the
  60.              'heapcode' file
  61.          int address of heap manager workspace
  62.  
  63. This routine must be called before PROCshell_Init.
  64.  
  65. --------------------------------------------------------
  66.  
  67. FNshell_HeapBlockExists()
  68. Params =>
  69.          int  address to check
  70.  
  71.        <=
  72.          bool TRUE or FALSE
  73.  
  74. This routine returns TRUE if a heapblock is present
  75. at the specified address, FALSE otherwise.
  76.  
  77. --------------------------------------------------------
  78.  
  79. PROCshell_MemFill()
  80. Params =>
  81.          int start address
  82.          int number of bytes
  83.          int byte value to fill with
  84.  
  85. --------------------------------------------------------
  86.  
  87. FNshell_HeapBlockExtendMid()
  88. =>    int    address of heap block
  89.     int    amount to increase or decrease block size by
  90.          (-ve to decrease)
  91.     int    offset at which to extend block
  92.  
  93. <=    int    address of heap block
  94.  
  95. Increases or decreases the size of the given heap block
  96. which must have been allocated with <FNshell_HeapBlockFetch>.
  97. Note that the heap block may be moved to make it fit so you
  98. should always use the returned value for the heap block
  99. address after this call.
  100.  
  101. --------------------------------------------------------