Versions Compared

Key

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

...

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 nextit handle isproperly
given
the SAME number

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

 

...