...
Code Block | ||
---|---|---|
| ||
IN: A = memory mask arguments (several arguments OR'ed together): Destination segment (allocated memory addressed for segment): MM_S0 ($00), segment 0 MM_S1 ($40), segment 1 MM_S2 ($80), segment 2 MM_S3 ($C0), segment 3 Source of memory (to be allocated): MM_FIX ($02), fixed workspace (not subject to swapping) or MM_SLT ($04), explicit slot usage, mask also following: MM_EXC ($10), exclusive use of bank MCMM_CIMUL ($10$20), internaluse memorymultiple banks B = 0, always MC_C1 ($01), card 1 MC_C2 ($02), card 2 C = bank or slot number if MM_SLT = 1 and MM_MUL = 0 MC_AS ($00), find an exclusive bank in any slot MC_C3CI ($03$10), cardinternal memory 3 MC_C1 ($01), Allocationcard variations:1 MMMC_EXCC2 ($10$02), exclusivecard use2 of bank MMMC_MULC3 ($20$03), usecard multiple3 banks or ($20-$ff), explicit bank BC = 0, always OUT, if call successful: Fc = 0 IX = memory pool handle OUT, if call failed: Fc = 1 A = error code: RC_NA ($06), handle not available RC_ROOM ($07), no room Registers changed after return: A.FBCDEHL/..IY same .F......./IX.. different |
Notes
MM_EXC and MC_CI use the same argument bit. MM_EXC isn't implemented.
...
If only destination segment is specified, you get memory from bank with
most with most free space. Pool is limited to one bank.
OS_Mop doesn't allocate any memory, so even the very first OS_Mal can
fail can fail.
If you specified MM_MUL, you can force slot 1-3 during first
OS_Mal by loading A with slot number
If you didn't specify MM_MUL, all memory allocated from that pool is
guaranteed to be in same bank. Additionally, memory area returned from
OS_Mal is guaranteed to be in single page.
If only the memory segment mask are specified, it is probably default'ed to MM_MUL. MM_FIX is probably an internal usage is specified, memory is allocated from all the memory available (pool is not limited to one bank).
If MM_EXC is specified, memory is allocated from free banks in priority, pool is not limited to one bank (OZ 5.0 and newer).
If MM_FIX is specified, only memory not subject to swap is allocated.
If MM_SLT is specified, C holds bank number ($20-$FF) or slot.
If you specified MM_MUL, you can force slot 1-3 during first OS_Mal by loading A with slot number.
Related calls
OS_Bix, Bind in extended address
OS_Box, restore bindings after OS_Bix
OS_Fc, select fast code (fast bank switching)
OS_Mal, allocate memory
OS_Mcl, close memory (free memory pool)
OS_Mfr, free (previously allocated block) memory
OS_Mgb, get current bank binding in segment
OS_Mpb, set new bank binding in segment
OZ_Mgb, get current bank binding in segment
OZ_Mpb, set new bank binding in segment