Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Code Block
titleRST 20H, DEFB $7B
IN:
     LA = reason code
     Other register parameters depend on reason code
OUT:
     Depends on reason code, see below. 
 

...

Internal operating system usage. This call is used to allocate all I/O type handles. The handle type and structure is documented in handle.def file. 


Code Block
titleFN_AH (A = $01), Allocate handle
IN:  A = FN_AH ($01)
	 B = handle type
     B = 0, doesreturns notthe allocatefirst afree handle, properlydoes -not theallocate next handle is given the SAME numberit properly

OUT, if successful:
     Fc = 0, IX = handle

OUT, if failed:
     Fc = 1, A = RC_ROOM

Registers changed after return:
     ..BCDEHL/..IY same
     AF....../IX.. different

 

...



Code Block
titleFN_VH (A = $02), Verify handle
IN:  A = FN_VH ($02)
     B = handle type
     IX = handle

OUT, if successful:
     Fc = 0

OUT, if failed
     Fc = 1, A = RC_ROOM

Registers changed after return:
     ..BCDEHL/IXIY same
     AF....../.... different

...

Code Block
titleFN_FH (A = $03), Free handle
IN:  A = FN_FH ($03)
     B = handle type
     IX = handle

OUT, if successful:
     Fc = 0, IX = 0

OUT, if failed:
     Fc = 1, A = RC_HAND

Registers changed after return:
     ..BCDEHL/..IY same
     AF....../IX.. different



Code Block
titleFN_AH GH (A = $04), Get (Find) handle (OZ 4.6 and newer)
IN:  A = FN_GH ($04)
     IX = first handle to test, 0 to begin with top handle
     B = handle type, 0 for any type
     C = dyn id, 0 tofor bypassany thedyn checkid

OUT, if successful:
     Fc = 0, IX = handle

OUT, if failed:
     Fc = 1, A = RC_EOF

Registers changed after return:
     ..BCDEHL/..IY same
     AF....../IX.. different



Code Block
titleFN_NH CH (A = $05), Get next Change handle of same type (OZ 40Z 5.6 0 and newer)
IN:  A = FN_NHCH ($05)
	 B = old type
	 C = new type
     IX = handle
to test
OUT, if successful:
     Fc = 0, IX = same handle
OUT, if failed:
     Fc = 1, A = RC_EOFHand (old type wrong)

Registers changed after return:
     .A.BCDEHL/..IYIXIY same
     AF.F....../IX.... different

 

...