LocalHandleDelta

Sets the number of handle table entries to be allocated when the local heap manager runs out of handle table entries for local moveable objects.

short WINAPI LocalHandleDelta(
short nNewDelta
);

nNewDelta – A short integer value specifying the number of handle table entries to be allocated (the “handle delta”). If nNewDelta is zero, the current handle delta is returned without change.

Returns the current handle delta (after applying any change).

The local heap manager maintains a handle table for moveable objects. When the table becomes full, it allocates new entries in blocks; the size of this block is the handle delta.

This function allows an application to control the granularity of handle table expansion.

A larger delta reduces the frequency of expansions but consumes more memory; a smaller delta saves memory but may lead to more frequent expansions.

Used for fine‑tuning performance in applications that manipulate many moveable objects.

// Get current delta
short currentDelta = LocalHandleDelta(0);
 
// Set new delta to 16 entries
short oldDelta = LocalHandleDelta(16);

; AX = new delta (0 to query)
push ax
call LocalHandleDelta
; Returns AX = current (or new) delta

• LocalAlloc
• LocalReAlloc