Versions Compared

Key

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

...

Code Block
languagenone
titleDR_GET ($01), get a handle for a DOR name (internal usage)
 IN: -

OUT, if call successful:
     Fc = 0
     IX = DOR handle
     A = minor type (device, always)

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

Do not use this call. Instead use GN_Opf with A = OP_DOR to obtain a DOR handle.

Note

  • Operating system only. Do not use this call.
  • Instead use OS_Dor / DR_OP or GN_Opf / OP_DOR to obtain a DOR handle.
     
Code Block
languagenone
titleDR_DUP ($02), duplicate DOR
IN:
     IX = DOR handle
OUT, if call successful:
     Fc = 0
     BC = duplicate DOR handle (IX is still valid)

OUT, if call failed:
     Fc = 1
     BC = 0 (IX is still valid)
     A = error code
          RC_HAND ($08), bad DOR handle

Registers changed after return:
     ....DEHL/IXIY same
     AFBC..../.... different

...

Code Block
languagenone
titleDR_DEL ($07), delete DOR
IN:
     IX = DOR handle

OUT, if call successful:
     Fc = 0, DOR deleted
     IX = 0

OUT, if call failed:
     Fc = 1
     A = error code
          RC_HAND ($08), bad DOR handle

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

Note

This call deletes a DOR node and deallocates its memory used by filesystem (DN_Fil minor type only)

...

Code Block
titleDR_FRW ($0D), file record write (OZ 5.0 and newer)
IN:
     B = record type letter (Name, Creation, Update, eXtent, Efs, Attribute)
     DE = user buffer address (to store information to be written, always local, in S0 or S1)
     IX = DOR handle (device or file type)

OUT, if call successful:
     Fc = 0
     original IX DOR handle is still valid

OUT, if call failed:
     Fc = 1
     original IX is still valid
     A = error code
          RC_BAD ($04), bad argument

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

Note

Read notes about DR_FRR.


Code Block
titleDR_USE ($0E), handle in use (OZ 5.0 and newer)
IN:
     IX = DOR handle

OUT, if call successful:
     Fc = 0
     handle or device is NOT already in use

OUT, if call failed:
     Fc = 1
     original IX is still valid
     A = error code
          RC_USE, already in use

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

...