git.oblomov.eu Git - wine/blob - memory/local.c

   1 /*
   2  * Local heap functions
   3  *
   4  * Copyright 1995 Alexandre Julliard
   5  * Copyright 1996 Huw Davies
   6  */
   7
   8 /*
   9  * Note:
  10  * All local heap functions need the current DS as first parameter
  11  * when called from the emulation library, so they take one more
  12  * parameter than usual.
  13  */
  14
  15 #include "config.h"
  16
  17 #include <stdlib.h>
  18 #include <string.h>
  19 #include "wine/winbase16.h"
  20 #include "heap.h"
  21 #include "instance.h"
  22 #include "local.h"
  23 #include "module.h"
  24 #include "stackframe.h"
  25 #include "toolhelp.h"
  26 #include "debugtools.h"
  27 #include "callback.h"
  28
  29 DEFAULT_DEBUG_CHANNEL(local);
  30 DECLARE_DEBUG_CHANNEL(heap);
  31
  32 typedef struct
  33 {
  34 /* Arena header */
  35     WORD prev;          /* Previous arena | arena type */
  36     WORD next;          /* Next arena */
  37 /* Start of the memory block or free-list info */
  38     WORD size;          /* Size of the free block */
  39     WORD free_prev;     /* Previous free block */
  40     WORD free_next;     /* Next free block */
  41 } LOCALARENA;
  42
  43 #define ARENA_HEADER_SIZE      4
  44 #define ARENA_HEADER( handle) ((handle) - ARENA_HEADER_SIZE)
  45
  46   /* Arena types (stored in 'prev' field of the arena) */
  47 #define LOCAL_ARENA_FREE       0
  48 #define LOCAL_ARENA_FIXED      1
  49
  50 /* LocalNotify() msgs */
  51
  52 #define LN_OUTOFMEM     0
  53 #define LN_MOVE         1
  54 #define LN_DISCARD      2
  55
  56 /* Layout of a handle entry table
  57  *
  58  * WORD                     count of entries
  59  * LOCALHANDLEENTRY[count]  entries
  60  * WORD                     near ptr to next table
  61  */
  62 typedef struct
  63 {
  64     WORD addr;                /* Address of the MOVEABLE block */
  65     BYTE flags;               /* Flags for this block */
  66     BYTE lock;                /* Lock count */
  67 } LOCALHANDLEENTRY;
  68
  69 /*
  70  * We make addr = 4n + 2 and set *((WORD *)addr - 1) = &addr like Windows does
  71  * in case something actually relies on this.
  72  * Note that if the architecture does not allow unaligned accesses, we make
  73  * addr = 4n + 4 to avoid returning unaligned pointers from LocalAlloc etc.
  74  *
  75  * An unused handle has lock = flags = 0xff. In windows addr is that of next
  76  * free handle, at the moment in wine we set it to 0.
  77  *
  78  * A discarded block's handle has lock = addr = 0 and flags = 0x40
  79  * (LMEM_DISCARDED >> 8)
  80  */
  81
  82 #ifdef ALLOW_UNALIGNED_ACCESS
  83   #define MOVEABLE_PREFIX sizeof(HLOCAL16)
  84 #else
  85   #define MOVEABLE_PREFIX sizeof(int)
  86 #endif
  87
  88
  89 #include "pshpack1.h"
  90
  91 typedef struct
  92 {
  93     WORD check;                 /* 00 Heap checking flag */
  94     WORD freeze;                /* 02 Heap frozen flag */
  95     WORD items;                 /* 04 Count of items on the heap */
  96     WORD first;                 /* 06 First item of the heap */
  97     WORD pad1;                  /* 08 Always 0 */
  98     WORD last;                  /* 0a Last item of the heap */
  99     WORD pad2;                  /* 0c Always 0 */
 100     BYTE ncompact;              /* 0e Compactions counter */
 101     BYTE dislevel;              /* 0f Discard level */
 102     DWORD distotal;             /* 10 Total bytes discarded */
 103     WORD htable;                /* 14 Pointer to handle table */
 104     WORD hfree;                 /* 16 Pointer to free handle table */
 105     WORD hdelta;                /* 18 Delta to expand the handle table */
 106     WORD expand;                /* 1a Pointer to expand function (unused) */
 107     WORD pstat;                 /* 1c Pointer to status structure (unused) */
 108     FARPROC16 notify WINE_PACKED; /* 1e Pointer to LocalNotify() function */
 109     WORD lock;                  /* 22 Lock count for the heap */
 110     WORD extra;                 /* 24 Extra bytes to allocate when expanding */
 111     WORD minsize;               /* 26 Minimum size of the heap */
 112     WORD magic;                 /* 28 Magic number */
 113 } LOCALHEAPINFO;
 114
 115 #include "poppack.h"
 116
 117 #define LOCAL_HEAP_MAGIC  0x484c  /* 'LH' */
 118
 119 WORD USER_HeapSel = 0;  /* USER heap selector */
 120
 121   /* All local heap allocations are aligned on 4-byte boundaries */
 122 #define LALIGN(word)          (((word) + 3) & ~3)
 123
 124 #define ARENA_PTR(ptr,arena)       ((LOCALARENA *)((char*)(ptr)+(arena)))
 125 #define ARENA_PREV(ptr,arena)      (ARENA_PTR((ptr),(arena))->prev & ~3)
 126 #define ARENA_NEXT(ptr,arena)      (ARENA_PTR((ptr),(arena))->next)
 127 #define ARENA_FLAGS(ptr,arena)     (ARENA_PTR((ptr),(arena))->prev & 3)
 128
 129   /* determine whether the handle belongs to a fixed or a moveable block */
 130 #define HANDLE_FIXED(handle) (((handle) & 3) == 0)
 131 #define HANDLE_MOVEABLE(handle) (((handle) & 3) == 2)
 132
 133
 134 /* ### start build ### */
 135 extern WORD CALLBACK LOCAL_CallTo16_word_www(FARPROC16,WORD,HLOCAL16,WORD);
 136 /* ### stop build ### */
 137
 138 /***********************************************************************
 139  *           LOCAL_GetHeap
 140  *
 141  * Return a pointer to the local heap, making sure it exists.
 142  */
 143 static LOCALHEAPINFO *LOCAL_GetHeap( HANDLE16 ds )
 144 {
 145     LOCALHEAPINFO *pInfo;
 146     INSTANCEDATA *ptr = MapSL( MAKESEGPTR( ds, 0 ));
 147     TRACE("Heap at %p, %04x\n", ptr, (ptr != NULL ? ptr->heap : 0xFFFF));
 148     if (!ptr || !ptr->heap) return NULL;
 149     if (IsBadReadPtr16( (SEGPTR)MAKELONG(ptr->heap,ds), sizeof(LOCALHEAPINFO)))
 150     {
 151         WARN("Bad pointer\n");
 152         return NULL;
 153     }
 154     pInfo = (LOCALHEAPINFO*)((char*)ptr + ptr->heap);
 155     if (pInfo->magic != LOCAL_HEAP_MAGIC)
 156     {
 157         WARN("Bad magic\n");
 158         return NULL;
 159     }
 160     return pInfo;
 161 }
 162
 163
 164 /***********************************************************************
 165  *           LOCAL_MakeBlockFree
 166  *
 167  * Make a block free, inserting it in the free-list.
 168  * 'block' is the handle of the block arena; 'baseptr' points to
 169  * the beginning of the data segment containing the heap.
 170  */
 171 static void LOCAL_MakeBlockFree( char *baseptr, WORD block )
 172 {
 173     LOCALARENA *pArena, *pNext;
 174     WORD next;
 175
 176       /* Mark the block as free */
 177
 178     pArena = ARENA_PTR( baseptr, block );
 179     pArena->prev = (pArena->prev & ~3) | LOCAL_ARENA_FREE;
 180     pArena->size = pArena->next - block;
 181
 182       /* Find the next free block (last block is always free) */
 183
 184     next = pArena->next;
 185     for (;;)
 186     {
 187         pNext = ARENA_PTR( baseptr, next );
 188         if ((pNext->prev & 3) == LOCAL_ARENA_FREE) break;
 189         next = pNext->next;
 190     }
 191
 192     TRACE("%04x, next %04x\n", block, next );
 193       /* Insert the free block in the free-list */
 194
 195     pArena->free_prev = pNext->free_prev;
 196     pArena->free_next = next;
 197     ARENA_PTR(baseptr,pNext->free_prev)->free_next = block;
 198     pNext->free_prev  = block;
 199 }
 200
 201
 202 /***********************************************************************
 203  *           LOCAL_RemoveFreeBlock
 204  *
 205  * Remove a block from the free-list.
 206  * 'block' is the handle of the block arena; 'baseptr' points to
 207  * the beginning of the data segment containing the heap.
 208  */
 209 static void LOCAL_RemoveFreeBlock( char *baseptr, WORD block )
 210 {
 211       /* Mark the block as fixed */
 212
 213     LOCALARENA *pArena = ARENA_PTR( baseptr, block );
 214     pArena->prev = (pArena->prev & ~3) | LOCAL_ARENA_FIXED;
 215
 216       /* Remove it from the list */
 217
 218     ARENA_PTR(baseptr,pArena->free_prev)->free_next = pArena->free_next;
 219     ARENA_PTR(baseptr,pArena->free_next)->free_prev = pArena->free_prev;
 220 }
 221
 222
 223 /***********************************************************************
 224  *           LOCAL_AddBlock
 225  *
 226  * Insert a new block in the heap.
 227  * 'new' is the handle of the new block arena; 'baseptr' points to
 228  * the beginning of the data segment containing the heap; 'prev' is
 229  * the block before the new one.
 230  */
 231 static void LOCAL_AddBlock( char *baseptr, WORD prev, WORD new )
 232 {
 233     LOCALARENA *pPrev = ARENA_PTR( baseptr, prev );
 234     LOCALARENA *pNew  = ARENA_PTR( baseptr, new );
 235
 236     pNew->prev = (prev & ~3) | LOCAL_ARENA_FIXED;
 237     pNew->next = pPrev->next;
 238     ARENA_PTR(baseptr,pPrev->next)->prev &= 3;
 239     ARENA_PTR(baseptr,pPrev->next)->prev |= new;
 240     pPrev->next = new;
 241 }
 242
 243
 244 /***********************************************************************
 245  *           LOCAL_RemoveBlock
 246  *
 247  * Remove a block from the heap.
 248  * 'block' is the handle of the block arena; 'baseptr' points to
 249  * the beginning of the data segment containing the heap.
 250  */
 251 static void LOCAL_RemoveBlock( char *baseptr, WORD block )
 252 {
 253     LOCALARENA *pArena, *pTmp;
 254
 255       /* Remove the block from the free-list */
 256
 257     TRACE("\n");
 258     pArena = ARENA_PTR( baseptr, block );
 259     if ((pArena->prev & 3) == LOCAL_ARENA_FREE)
 260         LOCAL_RemoveFreeBlock( baseptr, block );
 261
 262       /* If the previous block is free, expand its size */
 263
 264     pTmp = ARENA_PTR( baseptr, pArena->prev & ~3 );
 265     if ((pTmp->prev & 3) == LOCAL_ARENA_FREE)
 266         pTmp->size += pArena->next - block;
 267
 268       /* Remove the block from the linked list */
 269
 270     pTmp->next = pArena->next;
 271     pTmp = ARENA_PTR( baseptr, pArena->next );
 272     pTmp->prev = (pTmp->prev & 3) | (pArena->prev & ~3);
 273 }
 274
 275
 276 /***********************************************************************
 277  *           LOCAL_PrintHeap
 278  */
 279 static void LOCAL_PrintHeap( HANDLE16 ds )
 280 {
 281     char *ptr;
 282     LOCALHEAPINFO *pInfo;
 283     WORD arena;
 284
 285     /* FIXME - the test should be done when calling the function!
 286                plus is not clear that we should print this info
 287                only when TRACE_ON is on! */
 288     if(!TRACE_ON(local)) return;
 289
 290     ptr = MapSL( MAKESEGPTR( ds, 0 ));
 291     pInfo = LOCAL_GetHeap( ds );
 292
 293     if (!pInfo)
 294     {
 295         DPRINTF( "Local Heap corrupted!  ds=%04x\n", ds );
 296         return;
 297     }
 298     DPRINTF( "Local Heap  ds=%04x first=%04x last=%04x items=%d\n",
 299              ds, pInfo->first, pInfo->last, pInfo->items );
 300
 301     arena = pInfo->first;
 302     for (;;)
 303     {
 304         LOCALARENA *pArena = ARENA_PTR(ptr,arena);
 305         DPRINTF( "  %04x: prev=%04x next=%04x type=%d\n", arena,
 306               pArena->prev & ~3, pArena->next, pArena->prev & 3 );
 307         if (arena == pInfo->first)
 308         {
 309             DPRINTF( "        size=%d free_prev=%04x free_next=%04x\n",
 310                      pArena->size, pArena->free_prev, pArena->free_next );
 311         }
 312         if ((pArena->prev & 3) == LOCAL_ARENA_FREE)
 313         {
 314             DPRINTF( "        size=%d free_prev=%04x free_next=%04x\n",
 315                      pArena->size, pArena->free_prev, pArena->free_next );
 316             if (pArena->next == arena) break;  /* last one */
 317             if (ARENA_PTR(ptr,pArena->free_next)->free_prev != arena)
 318             {
 319                 DPRINTF( "*** arena->free_next->free_prev != arena\n" );
 320                 break;
 321             }
 322         }
 323         if (pArena->next == arena)
 324         {
 325             DPRINTF( "*** last block is not marked free\n" );
 326             break;
 327         }
 328         if ((ARENA_PTR(ptr,pArena->next)->prev & ~3) != arena)
 329         {
 330             DPRINTF( "*** arena->next->prev != arena (%04x, %04x)\n",
 331                      pArena->next, ARENA_PTR(ptr,pArena->next)->prev);
 332             break;
 333         }
 334         arena = pArena->next;
 335     }
 336 }
 337
 338
 339 /***********************************************************************
 340  *           LocalInit   (KERNEL.4)
 341  */
 342 BOOL16 WINAPI LocalInit16( HANDLE16 selector, WORD start, WORD end )
 343 {
 344     char *ptr;
 345     WORD heapInfoArena, freeArena, lastArena;
 346     LOCALHEAPINFO *pHeapInfo;
 347     LOCALARENA *pArena, *pFirstArena, *pLastArena;
 348     NE_MODULE *pModule;
 349     BOOL16 ret = FALSE;
 350
 351       /* The initial layout of the heap is: */
 352       /* - first arena         (FIXED)      */
 353       /* - heap info structure (FIXED)      */
 354       /* - large free block    (FREE)       */
 355       /* - last arena          (FREE)       */
 356
 357     TRACE("%04x %04x-%04x\n", selector, start, end);
 358     if (!selector) selector = CURRENT_DS;
 359
 360     if (TRACE_ON(heap))
 361     {
 362         /* If TRACE_ON(heap) is set, the global heap blocks are */
 363         /* cleared before use, so we can test for double initialization. */
 364         if (LOCAL_GetHeap(selector))
 365         {
 366             ERR("Heap %04x initialized twice.\n", selector);
 367             LOCAL_PrintHeap(selector);
 368         }
 369     }
 370
 371     if (start == 0)
 372     {
 373         /* start == 0 means: put the local heap at the end of the segment */
 374
 375         DWORD size = GlobalSize16( GlobalHandle16( selector ) );
 376         start = (WORD)(size > 0xffff ? 0xffff : size) - 1;
 377         if ( end > 0xfffe ) end = 0xfffe;
 378         start -= end;
 379         end += start;
 380
 381         /* Paranoid check */
 382
 383         if ((pModule = NE_GetPtr( GlobalHandle16( selector ) )))
 384         {
 385             SEGTABLEENTRY *pSeg = NE_SEG_TABLE( pModule );
 386             int segNr;
 387
 388             for ( segNr = 0; segNr < pModule->seg_count; segNr++, pSeg++ )
 389                 if ( GlobalHandleToSel16(pSeg->hSeg) == selector )
 390                     break;
 391
 392             if ( segNr < pModule->seg_count )
 393             {
 394                 WORD minsize = pSeg->minsize;
 395                 if ( pModule->ss == segNr+1 )
 396                     minsize += pModule->stack_size;
 397
 398                 TRACE(" new start %04x, minstart: %04x\n", start, minsize);
 399             }
 400         }
 401     }
 402     ptr = MapSL( MAKESEGPTR( selector, 0 ) );
 403
 404     start = LALIGN( max( start, sizeof(INSTANCEDATA) ) );
 405     heapInfoArena = LALIGN(start + sizeof(LOCALARENA) );
 406     freeArena = LALIGN( heapInfoArena + ARENA_HEADER_SIZE
 407                         + sizeof(LOCALHEAPINFO) );
 408     lastArena = (end - sizeof(LOCALARENA)) & ~3;
 409
 410       /* Make sure there's enough space.       */
 411
 412     if (freeArena + sizeof(LOCALARENA) >= lastArena) goto done;
 413
 414       /* Initialise the first arena */
 415
 416     pFirstArena = ARENA_PTR( ptr, start );
 417     pFirstArena->prev      = start | LOCAL_ARENA_FIXED;
 418     pFirstArena->next      = heapInfoArena;
 419     pFirstArena->size      = LALIGN(sizeof(LOCALARENA));
 420     pFirstArena->free_prev = start;  /* this one */
 421     pFirstArena->free_next = freeArena;
 422
 423       /* Initialise the arena of the heap info structure */
 424
 425     pArena = ARENA_PTR( ptr, heapInfoArena );
 426     pArena->prev = start | LOCAL_ARENA_FIXED;
 427     pArena->next = freeArena;
 428
 429       /* Initialise the heap info structure */
 430
 431     pHeapInfo = (LOCALHEAPINFO *) (ptr + heapInfoArena + ARENA_HEADER_SIZE );
 432     memset( pHeapInfo, 0, sizeof(LOCALHEAPINFO) );
 433     pHeapInfo->items   = 4;
 434     pHeapInfo->first   = start;
 435     pHeapInfo->last    = lastArena;
 436     pHeapInfo->htable  = 0;
 437     pHeapInfo->hdelta  = 0x20;
 438     pHeapInfo->extra   = 0x200;
 439     pHeapInfo->minsize = lastArena - freeArena;
 440     pHeapInfo->magic   = LOCAL_HEAP_MAGIC;
 441
 442       /* Initialise the large free block */
 443
 444     pArena = ARENA_PTR( ptr, freeArena );
 445     pArena->prev      = heapInfoArena | LOCAL_ARENA_FREE;
 446     pArena->next      = lastArena;
 447     pArena->size      = lastArena - freeArena;
 448     pArena->free_prev = start;
 449     pArena->free_next = lastArena;
 450
 451       /* Initialise the last block */
 452
 453     pLastArena = ARENA_PTR( ptr, lastArena );
 454     pLastArena->prev      = freeArena | LOCAL_ARENA_FREE;
 455     pLastArena->next      = lastArena;  /* this one */
 456     pLastArena->size      = LALIGN(sizeof(LOCALARENA));
 457     pLastArena->free_prev = freeArena;
 458     pLastArena->free_next = lastArena;  /* this one */
 459
 460       /* Store the local heap address in the instance data */
 461
 462     ((INSTANCEDATA *)ptr)->heap = heapInfoArena + ARENA_HEADER_SIZE;
 463     LOCAL_PrintHeap( selector );
 464     ret = TRUE;
 465
 466  done:
 467     CURRENT_STACK16->ecx = ret;  /* must be returned in cx too */
 468     return ret;
 469 }
 470
 471 /***********************************************************************
 472  *           LOCAL_GrowHeap
 473  */
 474 static BOOL16 LOCAL_GrowHeap( HANDLE16 ds )
 475 {
 476     HANDLE16 hseg;
 477     LONG oldsize;
 478     LONG end;
 479     LOCALHEAPINFO *pHeapInfo;
 480     WORD freeArena, lastArena;
 481     LOCALARENA *pArena, *pLastArena;
 482     char *ptr;
 483
 484     hseg = GlobalHandle16( ds );
 485     /* maybe mem allocated by Virtual*() ? */
 486     if (!hseg) return FALSE;
 487
 488     oldsize = GlobalSize16( hseg );
 489     /* if nothing can be gained, return */
 490     if (oldsize > 0xfff0) return FALSE;
 491     hseg = GlobalReAlloc16( hseg, 0x10000, GMEM_FIXED );
 492     ptr = MapSL( MAKESEGPTR( ds, 0 ) );
 493     pHeapInfo = LOCAL_GetHeap( ds );
 494     if (pHeapInfo == NULL) {
 495         ERR("Heap not found\n" );
 496         return FALSE;
 497     }
 498     end = GlobalSize16( hseg );
 499     lastArena = (end - sizeof(LOCALARENA)) & ~3;
 500
 501       /* Update the HeapInfo */
 502     pHeapInfo->items++;
 503     freeArena = pHeapInfo->last;
 504     pHeapInfo->last = lastArena;
 505     pHeapInfo->minsize += end - oldsize;
 506
 507       /* grow the old last block */
 508     pArena = ARENA_PTR( ptr, freeArena );
 509     pArena->size      = lastArena - freeArena;
 510     pArena->next      = lastArena;
 511     pArena->free_next = lastArena;
 512
 513       /* Initialise the new last block */
 514
 515     pLastArena = ARENA_PTR( ptr, lastArena );
 516     pLastArena->prev      = freeArena | LOCAL_ARENA_FREE;
 517     pLastArena->next      = lastArena;  /* this one */
 518     pLastArena->size      = LALIGN(sizeof(LOCALARENA));
 519     pLastArena->free_prev = freeArena;
 520     pLastArena->free_next = lastArena;  /* this one */
 521
 522     /* If block before freeArena is also free then merge them */
 523     if((ARENA_PTR(ptr, (pArena->prev & ~3))->prev & 3) == LOCAL_ARENA_FREE)
 524     {
 525         LOCAL_RemoveBlock(ptr, freeArena);
 526         pHeapInfo->items--;
 527     }
 528
 529     TRACE("Heap expanded\n" );
 530     LOCAL_PrintHeap( ds );
 531     return TRUE;
 532 }
 533
 534
 535 /***********************************************************************
 536  *           LOCAL_FreeArena
 537  */
 538 static HLOCAL16 LOCAL_FreeArena( WORD ds, WORD arena )
 539 {
 540     char *ptr = MapSL( MAKESEGPTR( ds, 0 ) );
 541     LOCALHEAPINFO *pInfo;
 542     LOCALARENA *pArena, *pPrev, *pNext;
 543
 544     TRACE("%04x ds=%04x\n", arena, ds );
 545     if (!(pInfo = LOCAL_GetHeap( ds ))) return arena;
 546
 547     pArena = ARENA_PTR( ptr, arena );
 548     if ((pArena->prev & 3) == LOCAL_ARENA_FREE)
 549     {
 550         /* shouldn't happen */
 551         ERR("Trying to free block %04x twice!\n",
 552                  arena );
 553         LOCAL_PrintHeap( ds );
 554         return arena;
 555     }
 556
 557       /* Check if we can merge with the previous block */
 558
 559     pPrev = ARENA_PTR( ptr, pArena->prev & ~3 );
 560     pNext = ARENA_PTR( ptr, pArena->next );
 561     if ((pPrev->prev & 3) == LOCAL_ARENA_FREE)
 562     {
 563         arena  = pArena->prev & ~3;
 564         pArena = pPrev;
 565         LOCAL_RemoveBlock( ptr, pPrev->next );
 566         pInfo->items--;
 567     }
 568     else  /* Make a new free block */
 569     {
 570         LOCAL_MakeBlockFree( ptr, arena );
 571     }
 572
 573       /* Check if we can merge with the next block */
 574
 575     if ((pArena->next == pArena->free_next) &&
 576         (pArena->next != pInfo->last))
 577     {
 578         LOCAL_RemoveBlock( ptr, pArena->next );
 579         pInfo->items--;
 580     }
 581     return 0;
 582 }
 583
 584
 585 /***********************************************************************
 586  *           LOCAL_ShrinkArena
 587  *
 588  * Shrink an arena by creating a free block at its end if possible.
 589  * 'size' includes the arena header, and must be aligned.
 590  */
 591 static void LOCAL_ShrinkArena( WORD ds, WORD arena, WORD size )
 592 {
 593     char *ptr = MapSL( MAKESEGPTR( ds, 0 ) );
 594     LOCALARENA *pArena = ARENA_PTR( ptr, arena );
 595
 596     if (arena + size + LALIGN(sizeof(LOCALARENA)) < pArena->next)
 597     {
 598         LOCALHEAPINFO *pInfo = LOCAL_GetHeap( ds );
 599         if (!pInfo) return;
 600         LOCAL_AddBlock( ptr, arena, arena + size );
 601         pInfo->items++;
 602         LOCAL_FreeArena( ds, arena + size );
 603     }
 604 }
 605
 606
 607 /***********************************************************************
 608  *           LOCAL_GrowArenaDownward
 609  *
 610  * Grow an arena downward by using the previous arena (must be free).
 611  */
 612 static void LOCAL_GrowArenaDownward( WORD ds, WORD arena, WORD newsize )
 613 {
 614     char *ptr = MapSL( MAKESEGPTR( ds, 0 ) );
 615     LOCALHEAPINFO *pInfo;
 616     LOCALARENA *pArena = ARENA_PTR( ptr, arena );
 617     WORD prevArena = pArena->prev & ~3;
 618     LOCALARENA *pPrevArena = ARENA_PTR( ptr, prevArena );
 619     WORD offset, size;
 620     char *p;
 621
 622     if (!(pInfo = LOCAL_GetHeap( ds ))) return;
 623     offset = pPrevArena->size;
 624     size = pArena->next - arena - ARENA_HEADER_SIZE;
 625     LOCAL_RemoveFreeBlock( ptr, prevArena );
 626     LOCAL_RemoveBlock( ptr, arena );
 627     pInfo->items--;
 628     p = (char *)pPrevArena + ARENA_HEADER_SIZE;
 629     while (offset < size)
 630     {
 631         memcpy( p, p + offset, offset );
 632         p += offset;
 633         size -= offset;
 634     }
 635     if (size) memcpy( p, p + offset, size );
 636     LOCAL_ShrinkArena( ds, prevArena, newsize );
 637 }
 638
 639
 640
 641 /***********************************************************************
 642  *           LOCAL_GrowArenaUpward
 643  *
 644  * Grow an arena upward by using the next arena (must be free and big
 645  * enough). Newsize includes the arena header and must be aligned.
 646  */
 647 static void LOCAL_GrowArenaUpward( WORD ds, WORD arena, WORD newsize )
 648 {
 649     char *ptr = MapSL( MAKESEGPTR( ds, 0 ) );
 650     LOCALHEAPINFO *pInfo;
 651     LOCALARENA *pArena = ARENA_PTR( ptr, arena );
 652     WORD nextArena = pArena->next;
 653
 654     if (!(pInfo = LOCAL_GetHeap( ds ))) return;
 655     LOCAL_RemoveBlock( ptr, nextArena );
 656     pInfo->items--;
 657     LOCAL_ShrinkArena( ds, arena, newsize );
 658 }
 659
 660
 661 /***********************************************************************
 662  *           LOCAL_GetFreeSpace
 663  */
 664 static WORD LOCAL_GetFreeSpace(WORD ds, WORD countdiscard)
 665 {
 666     char *ptr = MapSL( MAKESEGPTR( ds, 0 ) );
 667     LOCALHEAPINFO *pInfo;
 668     LOCALARENA *pArena;
 669     WORD arena;
 670     WORD freespace = 0;
 671
 672     if (!(pInfo = LOCAL_GetHeap( ds )))
 673     {
 674         ERR("Local heap not found\n" );
 675         LOCAL_PrintHeap(ds);
 676         return 0;
 677     }
 678     arena = pInfo->first;
 679     pArena = ARENA_PTR( ptr, arena );
 680     while (arena != pArena->free_next)
 681     {
 682         arena = pArena->free_next;
 683         pArena = ARENA_PTR( ptr, arena );
 684         if (pArena->size >= freespace) freespace = pArena->size;
 685     }
 686     /* FIXME doesn't yet calculate space that would become free if everything
 687        were discarded when countdiscard == 1 */
 688     if (freespace < ARENA_HEADER_SIZE) freespace = 0;
 689     else freespace -= ARENA_HEADER_SIZE;
 690     return freespace;
 691 }
 692
 693
 694 /***********************************************************************
 695  *           LOCAL_Compact
 696  */
 697 WORD LOCAL_Compact( HANDLE16 ds, UINT16 minfree, UINT16 flags )
 698 {
 699     char *ptr = MapSL( MAKESEGPTR( ds, 0 ) );
 700     LOCALHEAPINFO *pInfo;
 701     LOCALARENA *pArena, *pMoveArena, *pFinalArena;
 702     WORD arena, movearena, finalarena, table;
 703     WORD count, movesize, size;
 704     WORD freespace;
 705     LOCALHANDLEENTRY *pEntry;
 706
 707     if (!(pInfo = LOCAL_GetHeap( ds )))
 708     {
 709         ERR("Local heap not found\n" );
 710         LOCAL_PrintHeap(ds);
 711         return 0;
 712     }
 713     TRACE("ds = %04x, minfree = %04x, flags = %04x\n",
 714                  ds, minfree, flags);
 715     freespace = LOCAL_GetFreeSpace(ds, minfree ? 0 : 1);
 716     if(freespace >= minfree || (flags & LMEM_NOCOMPACT))
 717     {
 718         TRACE("Returning %04x.\n", freespace);
 719         return freespace;
 720     }
 721     TRACE("Compacting heap %04x.\n", ds);
 722     table = pInfo->htable;
 723     while(table)
 724     {
 725         pEntry = (LOCALHANDLEENTRY *)(ptr + table + sizeof(WORD));
 726         for(count = *(WORD *)(ptr + table); count > 0; count--, pEntry++)
 727         {
 728             if((pEntry->lock == 0) && (pEntry->flags != (LMEM_DISCARDED >> 8)))
 729             {
 730                 /* OK we can move this one if we want */
 731                 TRACE("handle %04x (block %04x) can be moved.\n",
 732                              (WORD)((char *)pEntry - ptr), pEntry->addr);
 733                 movearena = ARENA_HEADER(pEntry->addr - MOVEABLE_PREFIX);
 734                 pMoveArena = ARENA_PTR(ptr, movearena);
 735                 movesize = pMoveArena->next - movearena;
 736                 arena = pInfo->first;
 737                 pArena = ARENA_PTR(ptr, arena);
 738                 size = 0xffff;
 739                 finalarena = 0;
 740                 /* Try to find the smallest arena that will do, */
 741                 /* which is below us in memory */
 742                 for(;;)
 743                 {
 744                     arena = pArena->free_next;
 745                     pArena = ARENA_PTR(ptr, arena);
 746                     if(arena >= movearena)
 747                         break;
 748                     if(arena == pArena->free_next)
 749                         break;
 750                     if((pArena->size >= movesize) && (pArena->size < size))
 751                     {
 752                         size = pArena->size;
 753                         finalarena = arena;
 754                     }
 755                 }
 756                 if (finalarena) /* Actually got somewhere to move */
 757                 {
 758                     TRACE("Moving it to %04x.\n", finalarena);
 759                     pFinalArena = ARENA_PTR(ptr, finalarena);
 760                     size = pFinalArena->size;
 761                     LOCAL_RemoveFreeBlock(ptr, finalarena);
 762                     LOCAL_ShrinkArena( ds, finalarena, movesize );
 763                     /* Copy the arena to it's new location */
 764                     memcpy((char *)pFinalArena + ARENA_HEADER_SIZE,
 765                            (char *)pMoveArena + ARENA_HEADER_SIZE,
 766                            movesize - ARENA_HEADER_SIZE );
 767                     /* Free the old location */
 768                     LOCAL_FreeArena(ds, movearena);
 769                     if (pInfo->notify)
 770                         LOCAL_CallTo16_word_www(pInfo->notify, LN_MOVE,
 771                         (WORD)((char *)pEntry - ptr), pEntry->addr);
 772                     /* Update handle table entry */
 773                     pEntry->addr = finalarena + ARENA_HEADER_SIZE + MOVEABLE_PREFIX;
 774                 }
 775                 else if((ARENA_PTR(ptr, pMoveArena->prev & ~3)->prev & 3)
 776                                == LOCAL_ARENA_FREE)
 777                 {
 778                     /* Previous arena is free (but < movesize)  */
 779                     /* so we can 'slide' movearena down into it */
 780                     finalarena = pMoveArena->prev & ~3;
 781                     LOCAL_GrowArenaDownward( ds, movearena, movesize );
 782                     /* Update handle table entry */
 783                     pEntry->addr = finalarena + ARENA_HEADER_SIZE + MOVEABLE_PREFIX;
 784                 }
 785             }
 786         }
 787         table = *(WORD *)pEntry;
 788     }
 789     freespace = LOCAL_GetFreeSpace(ds, minfree ? 0 : 1);
 790     if(freespace >= minfree || (flags & LMEM_NODISCARD))
 791     {
 792         TRACE("Returning %04x.\n", freespace);
 793         return freespace;
 794     }
 795
 796     table = pInfo->htable;
 797     while(table)
 798     {
 799         pEntry = (LOCALHANDLEENTRY *)(ptr + table + sizeof(WORD));
 800         for(count = *(WORD *)(ptr + table); count > 0; count--, pEntry++)
 801         {
 802             if(pEntry->addr && pEntry->lock == 0 &&
 803              (pEntry->flags & (LMEM_DISCARDABLE >> 8)))
 804             {
 805                 TRACE("Discarding handle %04x (block %04x).\n",
 806                               (char *)pEntry - ptr, pEntry->addr);
 807                 LOCAL_FreeArena(ds, ARENA_HEADER(pEntry->addr - MOVEABLE_PREFIX));
 808                 if (pInfo->notify)
 809                     LOCAL_CallTo16_word_www(pInfo->notify, LN_DISCARD,
 810                         (char *)pEntry - ptr, pEntry->flags);
 811                 pEntry->addr = 0;
 812                 pEntry->flags = (LMEM_DISCARDED >> 8);
 813             }
 814         }
 815         table = *(WORD *)pEntry;
 816     }
 817     return LOCAL_Compact(ds, 0xffff, LMEM_NODISCARD);
 818 }
 819
 820
 821 /***********************************************************************
 822  *           LOCAL_FindFreeBlock
 823  */
 824 static HLOCAL16 LOCAL_FindFreeBlock( HANDLE16 ds, WORD size )
 825 {
 826     char *ptr = MapSL( MAKESEGPTR( ds, 0 ) );
 827     LOCALHEAPINFO *pInfo;
 828     LOCALARENA *pArena;
 829     WORD arena;
 830
 831     if (!(pInfo = LOCAL_GetHeap( ds )))
 832     {
 833         ERR("Local heap not found\n" );
 834         LOCAL_PrintHeap(ds);
 835         return 0;
 836     }
 837
 838     arena = pInfo->first;
 839     pArena = ARENA_PTR( ptr, arena );
 840     for (;;) {
 841         arena = pArena->free_next;
 842         pArena = ARENA_PTR( ptr, arena );
 843         if (arena == pArena->free_next) break;
 844         if (pArena->size >= size) return arena;
 845     }
 846     TRACE("not enough space\n" );
 847     LOCAL_PrintHeap(ds);
 848     return 0;
 849 }
 850
 851
 852 /***********************************************************************
 853  *           get_heap_name
 854  */
 855 static const char *get_heap_name( WORD ds )
 856 {
 857     HINSTANCE16 inst = LoadLibrary16( "GDI" );
 858     if (ds == GlobalHandleToSel16( inst ))
 859     {
 860         FreeLibrary16( inst );
 861         return "GDI";
 862     }
 863     FreeLibrary16( inst );
 864     inst = LoadLibrary16( "USER" );
 865     if (ds == GlobalHandleToSel16( inst ))
 866     {
 867         FreeLibrary16( inst );
 868         return "USER";
 869     }
 870     FreeLibrary16( inst );
 871     return "local";
 872 }
 873
 874 /***********************************************************************
 875  *           LOCAL_GetBlock
 876  * The segment may get moved around in this function, so all callers
 877  * should reset their pointer variables.
 878  */
 879 static HLOCAL16 LOCAL_GetBlock( HANDLE16 ds, WORD size, WORD flags )
 880 {
 881     char *ptr = MapSL( MAKESEGPTR( ds, 0 ) );
 882     LOCALHEAPINFO *pInfo;
 883     LOCALARENA *pArena;
 884     WORD arena;
 885
 886     if (!(pInfo = LOCAL_GetHeap( ds )))
 887     {
 888         ERR("Local heap not found\n");
 889         LOCAL_PrintHeap(ds);
 890         return 0;
 891     }
 892
 893     size += ARENA_HEADER_SIZE;
 894     size = LALIGN( max( size, sizeof(LOCALARENA) ) );
 895
 896 #if 0
 897 notify_done:
 898 #endif
 899       /* Find a suitable free block */
 900     arena = LOCAL_FindFreeBlock( ds, size );
 901     if (arena == 0) {
 902         /* no space: try to make some */
 903         LOCAL_Compact( ds, size, flags );
 904         arena = LOCAL_FindFreeBlock( ds, size );
 905     }
 906     if (arena == 0) {
 907         /* still no space: try to grow the segment */
 908         if (!(LOCAL_GrowHeap( ds )))
 909         {
 910 #if 0
 911             /* FIXME: doesn't work correctly yet */
 912             if ((pInfo->notify) && (LOCAL_CallTo16_word_www(pInfo->notify, LN_OUTOFMEM, ds - 20, size))) /* FIXME: "size" correct ? (should indicate bytes needed) */
 913                 goto notify_done;
 914 #endif
 915             return 0;
 916         }
 917         ptr = MapSL( MAKESEGPTR( ds, 0 ) );
 918         pInfo = LOCAL_GetHeap( ds );
 919         arena = LOCAL_FindFreeBlock( ds, size );
 920     }
 921     if (arena == 0) {
 922         ERR( "not enough space in %s heap %04x for %d bytes\n",
 923              get_heap_name(ds), ds, size );
 924 #if 0
 925         if ((pInfo->notify) &&
 926         /* FIXME: "size" correct ? (should indicate bytes needed) */
 927         (LOCAL_CallTo16_word_www(pInfo->notify, LN_OUTOFMEM, ds, size)))
 928             goto notify_done;
 929 #endif
 930         return 0;
 931     }
 932
 933       /* Make a block out of the free arena */
 934     pArena = ARENA_PTR( ptr, arena );
 935     TRACE("size = %04x, arena %04x size %04x\n",
 936                   size, arena, pArena->size );
 937     LOCAL_RemoveFreeBlock( ptr, arena );
 938     LOCAL_ShrinkArena( ds, arena, size );
 939
 940     if (flags & LMEM_ZEROINIT)
 941         memset((char *)pArena + ARENA_HEADER_SIZE, 0, size-ARENA_HEADER_SIZE);
 942     return arena + ARENA_HEADER_SIZE;
 943 }
 944
 945
 946 /***********************************************************************
 947  *           LOCAL_NewHTable
 948  */
 949 static BOOL16 LOCAL_NewHTable( HANDLE16 ds )
 950 {
 951     char *ptr = MapSL( MAKESEGPTR( ds, 0 ) );
 952     LOCALHEAPINFO *pInfo;
 953     LOCALHANDLEENTRY *pEntry;
 954     HLOCAL16 handle;
 955     int i;
 956
 957     TRACE("\n" );
 958     if (!(pInfo = LOCAL_GetHeap( ds )))
 959     {
 960         ERR("Local heap not found\n");
 961         LOCAL_PrintHeap(ds);
 962         return FALSE;
 963     }
 964
 965     if (!(handle = LOCAL_GetBlock( ds, pInfo->hdelta * sizeof(LOCALHANDLEENTRY)
 966                                    + 2 * sizeof(WORD), LMEM_FIXED )))
 967         return FALSE;
 968     if (!(ptr = MapSL( MAKESEGPTR( ds, 0 ) )))
 969         ERR("ptr == NULL after GetBlock.\n");
 970     if (!(pInfo = LOCAL_GetHeap( ds )))
 971         ERR("pInfo == NULL after GetBlock.\n");
 972
 973     /* Fill the entry table */
 974
 975     *(WORD *)(ptr + handle) = pInfo->hdelta;
 976     pEntry = (LOCALHANDLEENTRY *)(ptr + handle + sizeof(WORD));
 977     for (i = pInfo->hdelta; i > 0; i--, pEntry++) {
 978         pEntry->lock = pEntry->flags = 0xff;
 979         pEntry->addr = 0;
 980     }
 981     *(WORD *)pEntry = pInfo->htable;
 982     pInfo->htable = handle;
 983     return TRUE;
 984 }
 985
 986
 987 /***********************************************************************
 988  *           LOCAL_GetNewHandleEntry
 989  */
 990 static HLOCAL16 LOCAL_GetNewHandleEntry( HANDLE16 ds )
 991 {
 992     char *ptr = MapSL( MAKESEGPTR( ds, 0 ) );
 993     LOCALHEAPINFO *pInfo;
 994     LOCALHANDLEENTRY *pEntry = NULL;
 995     WORD table;
 996
 997     if (!(pInfo = LOCAL_GetHeap( ds )))
 998     {
 999         ERR("Local heap not found\n");
1000         LOCAL_PrintHeap(ds);
1001         return 0;
1002     }
1003
1004     /* Find a free slot in existing tables */
1005
1006     table = pInfo->htable;
1007     while (table)
1008     {
1009         WORD count = *(WORD *)(ptr + table);
1010         pEntry = (LOCALHANDLEENTRY *)(ptr + table + sizeof(WORD));
1011         for (; count > 0; count--, pEntry++)
1012             if (pEntry->lock == 0xff) break;
1013         if (count) break;
1014         table = *(WORD *)pEntry;
1015     }
1016
1017     if (!table)  /* We need to create a new table */
1018     {
1019         if (!LOCAL_NewHTable( ds )) return 0;
1020         ptr = MapSL( MAKESEGPTR( ds, 0 ) );
1021         pInfo = LOCAL_GetHeap( ds );
1022         pEntry = (LOCALHANDLEENTRY *)(ptr + pInfo->htable + sizeof(WORD));
1023     }
1024
1025     /* Now allocate this entry */
1026
1027     pEntry->lock = 0;
1028     pEntry->flags = 0;
1029     TRACE("(%04x): %04x\n",
1030                    ds, ((char *)pEntry - ptr) );
1031     return (HLOCAL16)((char *)pEntry - ptr);
1032 }
1033
1034
1035 /***********************************************************************
1036  *           LOCAL_FreeHandleEntry
1037  *
1038  * Free a handle table entry.
1039  */
1040 static void LOCAL_FreeHandleEntry( HANDLE16 ds, HLOCAL16 handle )
1041 {
1042     char *ptr = MapSL( MAKESEGPTR( ds, 0 ) );
1043     LOCALHANDLEENTRY *pEntry = (LOCALHANDLEENTRY *)(ptr + handle);
1044     LOCALHEAPINFO *pInfo;
1045     WORD *pTable;
1046     WORD table, count, i;
1047
1048     if (!(pInfo = LOCAL_GetHeap( ds ))) return;
1049
1050     /* Find the table where this handle comes from */
1051
1052     pTable = &pInfo->htable;
1053     while (*pTable)
1054     {
1055         WORD size = (*(WORD *)(ptr + *pTable)) * sizeof(LOCALHANDLEENTRY);
1056         if ((handle >= *pTable + sizeof(WORD)) &&
1057             (handle < *pTable + sizeof(WORD) + size)) break;  /* Found it */
1058         pTable = (WORD *)(ptr + *pTable + sizeof(WORD) + size);
1059     }
1060     if (!*pTable)
1061     {
1062         ERR("Invalid entry %04x\n", handle);
1063         LOCAL_PrintHeap( ds );
1064         return;
1065     }
1066
1067     /* Make the entry free */
1068
1069     pEntry->addr = 0;  /* just in case */
1070     pEntry->lock = 0xff;
1071     pEntry->flags = 0xff;
1072     /* Now check if all entries in this table are free */
1073
1074     table = *pTable;
1075     pEntry = (LOCALHANDLEENTRY *)(ptr + table + sizeof(WORD));
1076     count = *(WORD *)(ptr + table);
1077     for (i = count; i > 0; i--, pEntry++) if (pEntry->lock != 0xff) return;
1078
1079     /* Remove the table from the linked list and free it */
1080
1081     TRACE("(%04x): freeing table %04x\n",
1082                    ds, table);
1083     *pTable = *(WORD *)pEntry;
1084     LOCAL_FreeArena( ds, ARENA_HEADER( table ) );
1085 }
1086
1087
1088 /***********************************************************************
1089  *           LOCAL_Free
1090  *
1091  * Implementation of LocalFree().
1092  */
1093 HLOCAL16 LOCAL_Free( HANDLE16 ds, HLOCAL16 handle )
1094 {
1095     char *ptr = MapSL( MAKESEGPTR( ds, 0 ) );
1096
1097     TRACE("%04x ds=%04x\n", handle, ds );
1098
1099     if (!handle) { WARN("Handle is 0.\n" ); return 0; }
1100     if (HANDLE_FIXED( handle ))
1101     {
1102         if (!LOCAL_FreeArena( ds, ARENA_HEADER( handle ) )) return 0;  /* OK */
1103         else return handle;  /* couldn't free it */
1104     }
1105     else
1106     {
1107         LOCALHANDLEENTRY *pEntry = (LOCALHANDLEENTRY *)(ptr + handle);
1108         if (pEntry->flags != (LMEM_DISCARDED >> 8))
1109         {
1110             TRACE("real block at %04x\n",
1111                            pEntry->addr );
1112             if (LOCAL_FreeArena( ds, ARENA_HEADER(pEntry->addr - MOVEABLE_PREFIX) ))
1113                 return handle; /* couldn't free it */
1114         }
1115         LOCAL_FreeHandleEntry( ds, handle );
1116         return 0;  /* OK */
1117     }
1118 }
1119
1120
1121 /***********************************************************************
1122  *           LOCAL_Alloc
1123  *
1124  * Implementation of LocalAlloc().
1125  *
1126  */
1127 HLOCAL16 LOCAL_Alloc( HANDLE16 ds, WORD flags, WORD size )
1128 {
1129     char *ptr;
1130     HLOCAL16 handle;
1131
1132     TRACE("%04x %d ds=%04x\n", flags, size, ds );
1133
1134     if(size > 0 && size <= 4) size = 5;
1135     if (flags & LMEM_MOVEABLE)
1136     {
1137         LOCALHANDLEENTRY *plhe;
1138         HLOCAL16 hmem;
1139
1140         if(size)
1141         {
1142             if (!(hmem = LOCAL_GetBlock( ds, size + MOVEABLE_PREFIX, flags )))
1143                 return 0;
1144         }
1145         else /* We just need to allocate a discarded handle */
1146             hmem = 0;
1147         if (!(handle = LOCAL_GetNewHandleEntry( ds )))
1148         {
1149             WARN("Couldn't get handle.\n");
1150             if(hmem)
1151                 LOCAL_FreeArena( ds, ARENA_HEADER(hmem) );
1152             return 0;
1153         }
1154         ptr = MapSL( MAKESEGPTR( ds, 0 ) );
1155         plhe = (LOCALHANDLEENTRY *)(ptr + handle);
1156         plhe->lock = 0;
1157         if(hmem)
1158         {
1159             plhe->addr = hmem + MOVEABLE_PREFIX;
1160             plhe->flags = (BYTE)((flags & 0x0f00) >> 8);
1161             *(HLOCAL16 *)(ptr + hmem) = handle;
1162         }
1163         else
1164         {
1165             plhe->addr = 0;
1166             plhe->flags = LMEM_DISCARDED >> 8;
1167         }
1168     }
1169     else /* FIXED */
1170     {
1171         if(!size)
1172             return 0;
1173         handle = LOCAL_GetBlock( ds, size, flags );
1174     }
1175     return handle;
1176 }
1177
1178
1179 /***********************************************************************
1180  *           LOCAL_ReAlloc
1181  *
1182  * Implementation of LocalReAlloc().
1183  */
1184 HLOCAL16 LOCAL_ReAlloc( HANDLE16 ds, HLOCAL16 handle, WORD size, WORD flags )
1185 {
1186     char *ptr = MapSL( MAKESEGPTR( ds, 0 ) );
1187     LOCALHEAPINFO *pInfo;
1188     LOCALARENA *pArena, *pNext;
1189     LOCALHANDLEENTRY *pEntry = NULL;
1190     WORD arena, oldsize;
1191     HLOCAL16 hmem, blockhandle;
1192     LONG nextarena;
1193
1194     if (!handle) return 0;
1195     if(HANDLE_MOVEABLE(handle) &&
1196      ((LOCALHANDLEENTRY *)(ptr + handle))->lock == 0xff) /* An unused handle */
1197         return 0;
1198
1199     TRACE("%04x %d %04x ds=%04x\n",
1200                    handle, size, flags, ds );
1201     if (!(pInfo = LOCAL_GetHeap( ds ))) return 0;
1202
1203     if (HANDLE_FIXED( handle ))
1204         blockhandle = handle;
1205     else
1206     {
1207         pEntry = (LOCALHANDLEENTRY *) (ptr + handle);
1208         if(pEntry->flags == (LMEM_DISCARDED >> 8))
1209         {
1210             HLOCAL16 hl;
1211             if(pEntry->addr)
1212                 WARN("Dicarded block has non-zero addr.\n");
1213             TRACE("ReAllocating discarded block\n");
1214             if(size <= 4) size = 5;
1215             if (!(hl = LOCAL_GetBlock( ds, size + MOVEABLE_PREFIX, flags)))
1216                 return 0;
1217             ptr = MapSL( MAKESEGPTR( ds, 0 ) );  /* Reload ptr */
1218             pEntry = (LOCALHANDLEENTRY *) (ptr + handle);
1219             pEntry->addr = hl + MOVEABLE_PREFIX;
1220             pEntry->flags = 0;
1221             pEntry->lock = 0;
1222             *(HLOCAL16 *)(ptr + hl) = handle;
1223             return handle;
1224         }
1225         if (((blockhandle = pEntry->addr - MOVEABLE_PREFIX) & 3) != 0)
1226         {
1227             ERR("(%04x,%04x): invalid handle\n",
1228                      ds, handle );
1229             return 0;
1230         }
1231         if (*(HLOCAL16 *)(ptr + blockhandle) != handle) {
1232             ERR("Back ptr to handle is invalid\n");
1233             return 0;
1234         }
1235     }
1236
1237     if (flags & LMEM_MODIFY)
1238     {
1239         if (HANDLE_MOVEABLE(handle))
1240         {
1241             pEntry = (LOCALHANDLEENTRY *)(ptr + handle);
1242             pEntry->flags = (flags & 0x0f00) >> 8;
1243             TRACE("Changing flags to %x.\n", pEntry->flags);
1244         }
1245         return handle;
1246     }
1247
1248     if (!size)
1249     {
1250         if (flags & LMEM_MOVEABLE)
1251         {
1252             if (HANDLE_FIXED(handle))
1253             {
1254                 TRACE("Freeing fixed block.\n");
1255                 return LOCAL_Free( ds, handle );
1256             }
1257             else /* Moveable block */
1258             {
1259                 pEntry = (LOCALHANDLEENTRY *)(ptr + handle);
1260                 if (pEntry->lock == 0)
1261                 {
1262                     /* discards moveable blocks */
1263                     TRACE("Discarding block\n");
1264                     LOCAL_FreeArena(ds, ARENA_HEADER(pEntry->addr - MOVEABLE_PREFIX));
1265                     pEntry->addr = 0;
1266                     pEntry->flags = (LMEM_DISCARDED >> 8);
1267                     return handle;
1268                 }
1269             }
1270             return 0;
1271         }
1272         else if(flags == 0)
1273         {
1274             pEntry = (LOCALHANDLEENTRY *)(ptr + handle);
1275             if (pEntry->lock == 0)
1276             {
1277                 /* Frees block */
1278                 return LOCAL_Free( ds, handle );
1279             }
1280         }
1281         return 0;
1282     }
1283
1284     arena = ARENA_HEADER( blockhandle );
1285     TRACE("arena is %04x\n", arena );
1286     pArena = ARENA_PTR( ptr, arena );
1287
1288     if(size <= 4) size = 5;
1289     if(HANDLE_MOVEABLE(handle)) size += MOVEABLE_PREFIX;
1290     oldsize = pArena->next - arena - ARENA_HEADER_SIZE;
1291     nextarena = LALIGN(blockhandle + size);
1292
1293       /* Check for size reduction */
1294
1295     if (nextarena <= pArena->next)
1296     {
1297         TRACE("size reduction, making new free block\n");
1298         LOCAL_ShrinkArena(ds, arena, nextarena - arena);
1299         TRACE("returning %04x\n", handle );
1300         return handle;
1301     }
1302
1303       /* Check if the next block is free and large enough */
1304
1305     pNext = ARENA_PTR( ptr, pArena->next );
1306     if (((pNext->prev & 3) == LOCAL_ARENA_FREE) &&
1307         (nextarena <= pNext->next))
1308     {
1309         TRACE("size increase, making new free block\n");
1310         LOCAL_GrowArenaUpward(ds, arena, nextarena - arena);
1311         TRACE("returning %04x\n", handle );
1312         return handle;
1313     }
1314
1315     /* Now we have to allocate a new block, but not if (fixed block or locked
1316        block) and no LMEM_MOVEABLE */
1317
1318     if (!(flags & LMEM_MOVEABLE))
1319     {
1320         if (HANDLE_FIXED(handle))
1321         {
1322             ERR("Needed to move fixed block, but LMEM_MOVEABLE not specified.\n");
1323             return 0;
1324         }
1325         else
1326         {
1327             if(((LOCALHANDLEENTRY *)(ptr + handle))->lock != 0)
1328             {
1329                 ERR("Needed to move locked block, but LMEM_MOVEABLE not specified.\n");
1330                 return 0;
1331             }
1332         }
1333     }
1334
1335     hmem = LOCAL_GetBlock( ds, size, flags );
1336     ptr = MapSL( MAKESEGPTR( ds, 0 ));  /* Reload ptr                             */
1337     if(HANDLE_MOVEABLE(handle))         /* LOCAL_GetBlock might have triggered    */
1338     {                                   /* a compaction, which might in turn have */
1339       blockhandle = pEntry->addr - MOVEABLE_PREFIX; /* moved the very block we are resizing */
1340       arena = ARENA_HEADER( blockhandle );   /* thus, we reload arena, too        */
1341     }
1342     if (!hmem)
1343     {
1344         /* Remove the block from the heap and try again */
1345         LPSTR buffer = HeapAlloc( GetProcessHeap(), 0, oldsize );
1346         if (!buffer) return 0;
1347         memcpy( buffer, ptr + arena + ARENA_HEADER_SIZE, oldsize );
1348         LOCAL_FreeArena( ds, arena );
1349         if (!(hmem = LOCAL_GetBlock( ds, size, flags )))
1350         {
1351             if (!(hmem = LOCAL_GetBlock( ds, oldsize, flags )))
1352             {
1353                 ERR("Can't restore saved block\n" );
1354                 HeapFree( GetProcessHeap(), 0, buffer );
1355                 return 0;
1356             }
1357             size = oldsize;
1358         }
1359         ptr = MapSL( MAKESEGPTR( ds, 0 ) );  /* Reload ptr */
1360         memcpy( ptr + hmem, buffer, oldsize );
1361         HeapFree( GetProcessHeap(), 0, buffer );
1362     }
1363     else
1364     {
1365         memcpy( ptr + hmem, ptr + (arena + ARENA_HEADER_SIZE), oldsize );
1366         LOCAL_FreeArena( ds, arena );
1367     }
1368     if (HANDLE_MOVEABLE( handle ))
1369     {
1370         TRACE("fixing handle\n");
1371         pEntry = (LOCALHANDLEENTRY *)(ptr + handle);
1372         pEntry->addr = hmem + MOVEABLE_PREFIX;
1373         /* Back ptr should still be correct */
1374         if(*(HLOCAL16 *)(ptr + hmem) != handle)
1375             ERR("back ptr is invalid.\n");
1376         hmem = handle;
1377     }
1378     if (size == oldsize) hmem = 0;  /* Realloc failed */
1379     TRACE("returning %04x\n", hmem );
1380     return hmem;
1381 }
1382
1383
1384 /***********************************************************************
1385  *           LOCAL_InternalLock
1386  */
1387 static HLOCAL16 LOCAL_InternalLock( LPSTR heap, HLOCAL16 handle )
1388 {
1389     HLOCAL16 old_handle = handle;
1390
1391     if (HANDLE_MOVEABLE(handle))
1392     {
1393         LOCALHANDLEENTRY *pEntry = (LOCALHANDLEENTRY *)(heap + handle);
1394         if (pEntry->flags == LMEM_DISCARDED) return 0;
1395         if (pEntry->lock < 0xfe) pEntry->lock++;
1396         handle = pEntry->addr;
1397     }
1398     TRACE("%04x returning %04x\n",
1399                    old_handle, handle );
1400     return handle;
1401 }
1402
1403
1404 /***********************************************************************
1405  *           LOCAL_Lock
1406  */
1407 void *LOCAL_Lock( HANDLE16 ds, HLOCAL16 handle )
1408 {
1409     char *ptr = MapSL( MAKESEGPTR( ds, 0 ) );
1410     return handle ? ptr + LOCAL_InternalLock( ptr, handle ) : NULL;
1411 }
1412
1413
1414 /***********************************************************************
1415  *           LOCAL_Unlock
1416  */
1417 BOOL16 LOCAL_Unlock( HANDLE16 ds, HLOCAL16 handle )
1418 {
1419     char *ptr = MapSL( MAKESEGPTR( ds, 0 ) );
1420
1421     TRACE("%04x\n", handle );
1422     if (HANDLE_MOVEABLE(handle))
1423     {
1424         LOCALHANDLEENTRY *pEntry = (LOCALHANDLEENTRY *)(ptr + handle);
1425         if (!pEntry->lock || (pEntry->lock == 0xff)) return FALSE;
1426         /* For moveable block, return the new lock count */
1427         /* (see _Windows_Internals_ p. 197) */
1428         return --pEntry->lock;
1429     }
1430     else return FALSE;
1431 }
1432
1433
1434 /***********************************************************************
1435  *           LOCAL_Size
1436  *
1437  * Implementation of LocalSize().
1438  */
1439 WORD LOCAL_Size( HANDLE16 ds, HLOCAL16 handle )
1440 {
1441     char *ptr = MapSL( MAKESEGPTR( ds, 0 ) );
1442     LOCALARENA *pArena;
1443
1444     TRACE("%04x ds=%04x\n", handle, ds );
1445
1446     if (!handle) return 0;
1447     if (HANDLE_MOVEABLE( handle ))
1448     {
1449         handle = *(WORD *)(ptr + handle);
1450         if (!handle) return 0;
1451         pArena = ARENA_PTR( ptr, ARENA_HEADER(handle - MOVEABLE_PREFIX) );
1452     }
1453     else
1454         pArena = ARENA_PTR( ptr, ARENA_HEADER(handle) );
1455
1456     return pArena->next - handle;
1457 }
1458
1459
1460 /***********************************************************************
1461  *           LOCAL_Flags
1462  *
1463  * Implementation of LocalFlags().
1464  */
1465 WORD LOCAL_Flags( HANDLE16 ds, HLOCAL16 handle )
1466 {
1467     char *ptr = MapSL( MAKESEGPTR( ds, 0 ) );
1468
1469     if (HANDLE_MOVEABLE(handle))
1470     {
1471         LOCALHANDLEENTRY *pEntry = (LOCALHANDLEENTRY *)(ptr + handle);
1472         TRACE("(%04x,%04x): returning %04x\n",
1473                        ds, handle, pEntry->lock | (pEntry->flags << 8) );
1474         return pEntry->lock | (pEntry->flags << 8);
1475     }
1476     else
1477     {
1478         TRACE("(%04x,%04x): returning 0\n",
1479                        ds, handle );
1480         return 0;
1481     }
1482 }
1483
1484
1485 /***********************************************************************
1486  *           LOCAL_HeapSize
1487  *
1488  * Implementation of LocalHeapSize().
1489  */
1490 WORD LOCAL_HeapSize( HANDLE16 ds )
1491 {
1492     LOCALHEAPINFO *pInfo = LOCAL_GetHeap( ds );
1493     if (!pInfo) return 0;
1494     return pInfo->last - pInfo->first;
1495 }
1496
1497
1498 /***********************************************************************
1499  *           LOCAL_CountFree
1500  *
1501  * Implementation of LocalCountFree().
1502  */
1503 WORD LOCAL_CountFree( HANDLE16 ds )
1504 {
1505     WORD arena, total;
1506     LOCALARENA *pArena;
1507     LOCALHEAPINFO *pInfo;
1508     char *ptr = MapSL( MAKESEGPTR( ds, 0 ) );
1509
1510     if (!(pInfo = LOCAL_GetHeap( ds )))
1511     {
1512         ERR("(%04x): Local heap not found\n", ds );
1513         LOCAL_PrintHeap( ds );
1514         return 0;
1515     }
1516
1517     total = 0;
1518     arena = pInfo->first;
1519     pArena = ARENA_PTR( ptr, arena );
1520     for (;;)
1521     {
1522         arena = pArena->free_next;
1523         pArena = ARENA_PTR( ptr, arena );
1524         if (arena == pArena->free_next) break;
1525         total += pArena->size;
1526     }
1527     TRACE("(%04x): returning %d\n", ds, total);
1528     return total;
1529 }
1530
1531
1532 /***********************************************************************
1533  *           LOCAL_Handle
1534  *
1535  * Implementation of LocalHandle().
1536  */
1537 HLOCAL16 LOCAL_Handle( HANDLE16 ds, WORD addr )
1538 {
1539     char *ptr = MapSL( MAKESEGPTR( ds, 0 ) );
1540     LOCALHEAPINFO *pInfo;
1541     WORD table;
1542
1543     if (!(pInfo = LOCAL_GetHeap( ds )))
1544     {
1545         ERR("(%04x): Local heap not found\n", ds );
1546         LOCAL_PrintHeap( ds );
1547         return 0;
1548     }
1549
1550     /* Find the address in the entry tables */
1551
1552     table = pInfo->htable;
1553     while (table)
1554     {
1555         WORD count = *(WORD *)(ptr + table);
1556         LOCALHANDLEENTRY *pEntry = (LOCALHANDLEENTRY*)(ptr+table+sizeof(WORD));
1557         for (; count > 0; count--, pEntry++)
1558             if (pEntry->addr == addr) return (HLOCAL16)((char *)pEntry - ptr);
1559         table = *(WORD *)pEntry;
1560     }
1561
1562     return (HLOCAL16)addr;  /* Fixed block handle is addr */
1563 }
1564
1565
1566 /***********************************************************************
1567  *           LocalAlloc16   (KERNEL.5)
1568  */
1569 HLOCAL16 WINAPI LocalAlloc16( UINT16 flags, WORD size )
1570 {
1571     HLOCAL16 ret = LOCAL_Alloc( CURRENT_DS, flags, size );
1572     CURRENT_STACK16->ecx = ret;  /* must be returned in cx too */
1573     return ret;
1574 }
1575
1576
1577 /***********************************************************************
1578  *           LocalReAlloc16   (KERNEL.6)
1579  */
1580 HLOCAL16 WINAPI LocalReAlloc16( HLOCAL16 handle, WORD size, UINT16 flags )
1581 {
1582     return LOCAL_ReAlloc( CURRENT_DS, handle, size, flags );
1583 }
1584
1585
1586 /***********************************************************************
1587  *           LocalFree16   (KERNEL.7)
1588  */
1589 HLOCAL16 WINAPI LocalFree16( HLOCAL16 handle )
1590 {
1591     return LOCAL_Free( CURRENT_DS, handle );
1592 }
1593
1594
1595 /***********************************************************************
1596  *           LocalLock16   (KERNEL.8)
1597  *
1598  * Note: only the offset part of the pointer is returned by the relay code.
1599  */
1600 SEGPTR WINAPI LocalLock16( HLOCAL16 handle )
1601 {
1602     WORD ds = CURRENT_DS;
1603     char *ptr = MapSL( MAKESEGPTR( ds, 0 ) );
1604     return MAKESEGPTR( ds, LOCAL_InternalLock( ptr, handle ) );
1605 }
1606
1607
1608 /***********************************************************************
1609  *           LocalUnlock16   (KERNEL.9)
1610  */
1611 BOOL16 WINAPI LocalUnlock16( HLOCAL16 handle )
1612 {
1613     return LOCAL_Unlock( CURRENT_DS, handle );
1614 }
1615
1616
1617 /***********************************************************************
1618  *           LocalSize16   (KERNEL.10)
1619  */
1620 UINT16 WINAPI LocalSize16( HLOCAL16 handle )
1621 {
1622     return LOCAL_Size( CURRENT_DS, handle );
1623 }
1624
1625
1626 /***********************************************************************
1627  *           LocalHandle16   (KERNEL.11)
1628  */
1629 HLOCAL16 WINAPI LocalHandle16( WORD addr )
1630 {
1631     return LOCAL_Handle( CURRENT_DS, addr );
1632 }
1633
1634
1635 /***********************************************************************
1636  *           LocalFlags16   (KERNEL.12)
1637  */
1638 UINT16 WINAPI LocalFlags16( HLOCAL16 handle )
1639 {
1640     return LOCAL_Flags( CURRENT_DS, handle );
1641 }
1642
1643
1644 /***********************************************************************
1645  *           LocalCompact16   (KERNEL.13)
1646  */
1647 UINT16 WINAPI LocalCompact16( UINT16 minfree )
1648 {
1649     TRACE("%04x\n", minfree );
1650     return LOCAL_Compact( CURRENT_DS, minfree, 0 );
1651 }
1652
1653
1654 /***********************************************************************
1655  *           LocalNotify   (KERNEL.14)
1656  *
1657  * Installs a callback function that is called for local memory events
1658  * Callback function prototype is
1659  * BOOL16 NotifyFunc(WORD wMsg, HLOCAL16 hMem, WORD wArg)
1660  * wMsg:
1661  * - LN_OUTOFMEM
1662  *   NotifyFunc seems to be responsible for allocating some memory,
1663  *   returns TRUE for success.
1664  *   wArg = number of bytes needed additionally
1665  * - LN_MOVE
1666  *   hMem = handle; wArg = old mem location
1667  * - LN_DISCARD
1668  *   NotifyFunc seems to be strongly encouraged to return TRUE,
1669  *   otherwise LogError() gets called.
1670  *   hMem = handle; wArg = flags
1671  */
1672 FARPROC16 WINAPI LocalNotify16( FARPROC16 func )
1673 {
1674     LOCALHEAPINFO *pInfo;
1675     FARPROC16 oldNotify;
1676     HANDLE16 ds = CURRENT_DS;
1677
1678     if (!(pInfo = LOCAL_GetHeap( ds )))
1679     {
1680         ERR("(%04x): Local heap not found\n", ds );
1681         LOCAL_PrintHeap( ds );
1682         return 0;
1683     }
1684     TRACE("(%04x): %08lx\n", ds, (DWORD)func );
1685     FIXME("Half implemented\n");
1686     oldNotify = pInfo->notify;
1687     pInfo->notify = func;
1688     return oldNotify;
1689 }
1690
1691
1692 /***********************************************************************
1693  *           LocalShrink16   (KERNEL.121)
1694  */
1695 UINT16 WINAPI LocalShrink16( HGLOBAL16 handle, UINT16 newsize )
1696 {
1697     TRACE("%04x %04x\n", handle, newsize );
1698     return 0;
1699 }
1700
1701
1702 /***********************************************************************
1703  *           GetHeapSpaces   (KERNEL.138)
1704  */
1705 DWORD WINAPI GetHeapSpaces16( HMODULE16 module )
1706 {
1707     NE_MODULE *pModule;
1708     WORD ds;
1709
1710     if (!(pModule = NE_GetPtr( module ))) return 0;
1711     ds =
1712     GlobalHandleToSel16((NE_SEG_TABLE( pModule ) + pModule->dgroup - 1)->hSeg);
1713     return MAKELONG( LOCAL_CountFree( ds ), LOCAL_HeapSize( ds ) );
1714 }
1715
1716
1717 /***********************************************************************
1718  *           LocalCountFree   (KERNEL.161)
1719  */
1720 WORD WINAPI LocalCountFree16(void)
1721 {
1722     return LOCAL_CountFree( CURRENT_DS );
1723 }
1724
1725
1726 /***********************************************************************
1727  *           LocalHeapSize   (KERNEL.162)
1728  */
1729 WORD WINAPI LocalHeapSize16(void)
1730 {
1731     TRACE("(void)\n" );
1732     return LOCAL_HeapSize( CURRENT_DS );
1733 }
1734
1735
1736 /***********************************************************************
1737  *           LocalHandleDelta   (KERNEL.310)
1738  */
1739 WORD WINAPI LocalHandleDelta16( WORD delta )
1740 {
1741     LOCALHEAPINFO *pInfo;
1742
1743     if (!(pInfo = LOCAL_GetHeap( CURRENT_DS )))
1744     {
1745         ERR("Local heap not found\n");
1746         LOCAL_PrintHeap( CURRENT_DS );
1747         return 0;
1748     }
1749     if (delta) pInfo->hdelta = delta;
1750     TRACE("returning %04x\n", pInfo->hdelta);
1751     return pInfo->hdelta;
1752 }
1753
1754
1755 /***********************************************************************
1756  *           LocalInfo   (TOOLHELP.56)
1757  */
1758 BOOL16 WINAPI LocalInfo16( LOCALINFO *pLocalInfo, HGLOBAL16 handle )
1759 {
1760     LOCALHEAPINFO *pInfo = LOCAL_GetHeap(SELECTOROF(K32WOWGlobalLock16(handle)));
1761     if (!pInfo) return FALSE;
1762     pLocalInfo->wcItems = pInfo->items;
1763     return TRUE;
1764 }
1765
1766
1767 /***********************************************************************
1768  *           LocalFirst   (TOOLHELP.57)
1769  */
1770 BOOL16 WINAPI LocalFirst16( LOCALENTRY *pLocalEntry, HGLOBAL16 handle )
1771 {
1772     WORD ds = GlobalHandleToSel16( handle );
1773     char *ptr = MapSL( MAKESEGPTR( ds, 0 ) );
1774     LOCALHEAPINFO *pInfo = LOCAL_GetHeap( ds );
1775     if (!pInfo) return FALSE;
1776
1777     pLocalEntry->hHandle   = pInfo->first + ARENA_HEADER_SIZE;
1778     pLocalEntry->wAddress  = pLocalEntry->hHandle;
1779     pLocalEntry->wFlags    = LF_FIXED;
1780     pLocalEntry->wcLock    = 0;
1781     pLocalEntry->wType     = LT_NORMAL;
1782     pLocalEntry->hHeap     = handle;
1783     pLocalEntry->wHeapType = NORMAL_HEAP;
1784     pLocalEntry->wNext     = ARENA_PTR(ptr,pInfo->first)->next;
1785     pLocalEntry->wSize     = pLocalEntry->wNext - pLocalEntry->hHandle;
1786     return TRUE;
1787 }
1788
1789
1790 /***********************************************************************
1791  *           LocalNext   (TOOLHELP.58)
1792  */
1793 BOOL16 WINAPI LocalNext16( LOCALENTRY *pLocalEntry )
1794 {
1795     WORD ds = GlobalHandleToSel16( pLocalEntry->hHeap );
1796     char *ptr = MapSL( MAKESEGPTR( ds, 0 ) );
1797     LOCALARENA *pArena;
1798
1799     if (!LOCAL_GetHeap( ds )) return FALSE;
1800     if (!pLocalEntry->wNext) return FALSE;
1801     pArena = ARENA_PTR( ptr, pLocalEntry->wNext );
1802
1803     pLocalEntry->hHandle   = pLocalEntry->wNext + ARENA_HEADER_SIZE;
1804     pLocalEntry->wAddress  = pLocalEntry->hHandle;
1805     pLocalEntry->wFlags    = (pArena->prev & 3) + 1;
1806     pLocalEntry->wcLock    = 0;
1807     pLocalEntry->wType     = LT_NORMAL;
1808     if (pArena->next != pLocalEntry->wNext)  /* last one? */
1809         pLocalEntry->wNext = pArena->next;
1810     else
1811         pLocalEntry->wNext = 0;
1812     pLocalEntry->wSize     = pLocalEntry->wNext - pLocalEntry->hHandle;
1813     return TRUE;
1814 }
1815
1816
1817 /***********************************************************************
1818  *           LocalAlloc   (KERNEL32.371)
1819  * RETURNS
1820  *      Handle: Success
1821  *      NULL: Failure
1822  */
1823 HLOCAL WINAPI LocalAlloc(
1824                 UINT flags, /* [in] Allocation attributes */
1825                 DWORD size    /* [in] Number of bytes to allocate */
1826 ) {
1827     return (HLOCAL)GlobalAlloc( flags, size );
1828 }
1829
1830
1831 /***********************************************************************
1832  *           LocalCompact   (KERNEL32.372)
1833  */
1834 UINT WINAPI LocalCompact( UINT minfree )
1835 {
1836     return 0;  /* LocalCompact does nothing in Win32 */
1837 }
1838
1839
1840 /***********************************************************************
1841  *           LocalFlags   (KERNEL32.374)
1842  * RETURNS
1843  *      Value specifying allocation flags and lock count.
1844  *      LMEM_INVALID_HANDLE: Failure
1845  */
1846 UINT WINAPI LocalFlags(
1847               HLOCAL handle /* [in] Handle of memory object */
1848 ) {
1849     return GlobalFlags( (HGLOBAL)handle );
1850 }
1851
1852
1853 /***********************************************************************
1854  *           LocalFree   (KERNEL32.375)
1855  * RETURNS
1856  *      NULL: Success
1857  *      Handle: Failure
1858  */
1859 HLOCAL WINAPI LocalFree(
1860                 HLOCAL handle /* [in] Handle of memory object */
1861 ) {
1862     return (HLOCAL)GlobalFree( (HGLOBAL)handle );
1863 }
1864
1865
1866 /***********************************************************************
1867  *           LocalHandle   (KERNEL32.376)
1868  * RETURNS
1869  *      Handle: Success
1870  *      NULL: Failure
1871  */
1872 HLOCAL WINAPI LocalHandle(
1873                 LPCVOID ptr /* [in] Address of local memory object */
1874 ) {
1875     return (HLOCAL)GlobalHandle( ptr );
1876 }
1877
1878
1879 /***********************************************************************
1880  *           LocalLock   (KERNEL32.377)
1881  * Locks a local memory object and returns pointer to the first byte
1882  * of the memory block.
1883  *
1884  * RETURNS
1885  *      Pointer: Success
1886  *      NULL: Failure
1887  */
1888 LPVOID WINAPI LocalLock(
1889               HLOCAL handle /* [in] Address of local memory object */
1890 ) {
1891     return GlobalLock( (HGLOBAL)handle );
1892 }
1893
1894
1895 /***********************************************************************
1896  *           LocalReAlloc   (KERNEL32.378)
1897  * RETURNS
1898  *      Handle: Success
1899  *      NULL: Failure
1900  */
1901 HLOCAL WINAPI LocalReAlloc(
1902                 HLOCAL handle, /* [in] Handle of memory object */
1903                 DWORD size,      /* [in] New size of block */
1904                 UINT flags     /* [in] How to reallocate object */
1905 ) {
1906     return (HLOCAL)GlobalReAlloc( (HGLOBAL)handle, size, flags );
1907 }
1908
1909
1910 /***********************************************************************
1911  *           LocalShrink   (KERNEL32.379)
1912  */
1913 UINT WINAPI LocalShrink( HGLOBAL handle, UINT newsize )
1914 {
1915     return 0;  /* LocalShrink does nothing in Win32 */
1916 }
1917
1918
1919 /***********************************************************************
1920  *           LocalSize   (KERNEL32.380)
1921  * RETURNS
1922  *      Size: Success
1923  *      0: Failure
1924  */
1925 UINT WINAPI LocalSize(
1926               HLOCAL handle /* [in] Handle of memory object */
1927 ) {
1928     return GlobalSize( (HGLOBAL)handle );
1929 }
1930
1931
1932 /***********************************************************************
1933  *           LocalUnlock   (KERNEL32.381)
1934  * RETURNS
1935  *      TRUE: Object is still locked
1936  *      FALSE: Object is unlocked
1937  */
1938 BOOL WINAPI LocalUnlock(
1939               HLOCAL handle /* [in] Handle of memory object */
1940 ) {
1941     return GlobalUnlock( (HGLOBAL)handle );
1942 }