OS_Mpb, Set new bank binding in segment

Owned by Gunther Strube
Last updated: Jun 10, 2014
1 min read

Register parameters

RST 20H, DEFB $5D
 IN:
     C = memory segment specifier (MS_S0, MS_S1, MS_S2 & MS_S3)
     B = bank number to bind into this segment ($00 - $FF)

OUT, if call successful:
     Fc = 0
     B = bank number previously bound to that segment
OUT, if call failed:
     Fc = 1
     A = error code:
          RC_ERR ($0F), C was not valid

Registers changed after return:
     ...CDEHL/IXIY same
     AFB...../.... different

Notes

If your application is designed to run in OZ V4.1 or newer, use RST OZ_MPB for faster execution. Alternatively, use OS_Fc to implement fast bank switching in your application (compatible with all OZ ROM releases).

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_Mop, open memory (allocate memory pool)
OZ_Mgb, get current bank binding in segment
OZ_Mpb, set new bank binding in segment

web analytics