WebSVN – Kolibri OS – Diff – /kernel/trunk/docs/sysfuncs.txt

   * eсx = slot number
 Returned value:
   * eax = if successful - pointer to a memory with data
   * eax = 1 - error
   * eax = -1 - main list area not found
-Remarks:
-  * The function must be used in conjunction with 68.11. The
-    application must pre-initialize the local heap by calling 68.11.
 ---------------------- Constants for registers: ----------------------
   eax - SF_CLIPBOARD (54)
   ebx - SSF_READ_CB (1)
 Returned value:
   * eax = 0 - success
   * eax = 1 - not enough memory
 Remarks:
   * There is another way to dynamically allocate/free memory -
-    subfunctions 11, 12, 13 of function 68.
+    subfunctions 12, 13 and 20 of function 68, but after creation
-  * The function cannot be used together with 68.11, 68.12, 68.13.
-    The function call will be ignored after creation of process heap
+    of the process heap 64 function call will be ignored.
-    with function 68.11.
 ---------------------- Constants for registers: ----------------------
   eax - SF_MEMORY_RESIZE (64)
 ======================================================================
 ---------------------- Constants for registers: ----------------------
   eax - SF_SYS_MISC (68)
   ebx - SSF_WRITE_MSR (4)
 ======================================================================
-======= Function 68, subfunction 11 - initialize process heap. =======
+=== Function 68, subfunction 11 - manually initialize process heap ===
 ======================================================================
 Parameters:
   * eax = 68 - function number
   * ebx = 11 - subfunction number
 Returned value:
   * eax = 0 - failed
   * otherwise size of created heap
 Remarks:
-  * The function call initializes heap, from which one can in future
+  * The function call initializes heap for subfunctions 12, 13 and 20.
+  * If the process heap is already created, this function will return
-    allocate and free memory blocks with subfunctions 12 and 13.
+    the size of the existing heap.
-    Heap size is equal to total amount of free application memory.
-  * The second function call from the same process results in
-    returning the size of the existing heap.
+    Heap size is equal to total amount of free application memory.
   * After creation of the heap calls to function 64 will be ignored.
 ---------------------- Constants for registers: ----------------------
   * ebx = 12 - subfunction number
   * ecx = required size in bytes
 Returned value:
   * eax = pointer to the allocated block
 Remarks:
-  * Before this call one must initialize process heap by call to
-    subfunction 11.
   * The function allocates an integer number of pages (4 Kb) in such
     way that the real size of allocated block is more than or equal to
     requested size.
   * ecx = new size in bytes
   * edx = pointer to already allocated block
 Returned value:
   * eax = pointer to the reallocated block, 0 = error
 Remarks:
-  * Before this call one must initialize process heap by call to
-    subfunction 11.
   * The function allocates an integer number of pages (4 Kb) in such
     way that the real size of allocated block is more than or equal to
     requested size.
   * If edx=0, the function call is equivalent to memory allocation
     with subfunction 12. Otherwise the block at edx
   * E_NOTFOUND = 5
   * E_ACCESS = 10
   * E_NOMEM = 30
   * E_PARAM = 33
 Remarks:
-  * Before this call one must initialize process heap by call to
-    subfunction 11.
   * If a new area is created, access flags set maximal rights
     for other processes. An attempt from other process to open
     with denied rights will fail with error code E_ACCESS.
   * The process which has created an area always has write access.

Subversion Repositories Kolibri OS

(root)/kernel/trunk/docs/sysfuncs.txt – Rev 6891 → 6893