LocalInit

Initializes a local heap within a specified memory segment.

BOOL WINAPI LocalInit(
  WORD  wSegment,
  WORD  wOffset,
  WORD  wHeapSize
);

• wSegment - The selector of the segment in which to initialize the local heap.
• wOffset - The offset within the segment at which the heap should start.
• wHeapSize - The size, in bytes, of the heap to initialize.

• Returns non-zero if the heap is successfully initialized.
• Returns 0 if initialization fails.

• The function sets up a local heap manager within the provided segment, enabling local memory allocation functions to operate within that segment.
• Applications typically call LocalInit during initialization of a data segment or a dynamically allocated memory block intended for use as a local heap.
• First 16 bytes of segment used as system data area.

#include <windows.h>
 
BOOL WINAPI InitializeLocalHeap(WORD seg, WORD offset, WORD size) {
    return LocalInit(seg, offset, size);
}

; Assume AX = segment, DX = offset, CX = heap size
push ax          ; wSegment
push dx          ; wOffset
push cx          ; wHeapSize
call LocalInit   ; Returns AX = non-zero if success

• DGROUP, Local Heap and Atom Table
• LocalAlloc - Allocates memory from the local heap.
• LocalFree - Frees memory allocated from the local heap.
• LocalSize - Retrieves the size of a local memory block.
• LocalReAlloc - Reallocates a local memory block.