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, returns the first free handle, does not allocate it 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_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
     C = dyn id, 0 tofor bypassany thetype
check  OUT, if successful: C     Fc = 0, IX = handle

OUTdyn id, if0 failed:for any     Fc = 1, A = RC_EOF

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

Code Block
titleFN_NH (A = $05), Get next handle of same type (OZ 4.6 and newer)
IN:  A = FN_NH ($05)
     IX = handle to test
dyn id

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_CH (A = $06$05), Change handle type (0Z 5.0 and newer)
IN:  A = FN_CH ($06$05)
	 B = old type
	 C = new type
     IX = handle
OUT, if successful:
     Fc = 0, IX = same handle
OUT, if failed:
     Fc = 1, A = RC_Hand : bad handle (old type wrong)

Registers changed after return:
     A.BCDEHL/IXIY same
     .F....../.... different

...