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