XHDI

XHDI is a standard interface specifying basic functions to handle block storage devices. The interest of XHDI is to define standard extension to the (limited) Atari BIOS functions that (for instance) cannot handle lockable devices like ZIP or CDROMs.

When the XHDI standard is implemented by a device driver, the programmer gets access to the XHDI functions through the XHDI_Cookie.

Topics

• XHDI_Cookie Specification
  • Cookie Identifier
  • Contents
  • Caveats
• XHDIFunctionCallingProcedure
  • Calling Procedure
  • Parameters
  • Upon Return
• XHDIDeviceNumbers
  • Major Device Number
  • Major Device Number
• XHDIErrorCodes
  • TOS Error Codes
  • SCSI Error Codes
  • IDE Error Codes
  • Other Error Codes
• XHDIDriverSpecification
  • How to Extend An XHDI Driver
  • The 'RAW' Partition type
  • Recommended partition types
  • Arbitration

XHDI Function Reference

The XHDI Interface provides the programmer with the 19 functions listed below.

Important: Before going any further, you should read the XHDIFunctionCallingProcedure and XHDIErrorCodes.

• Opcode 0: XHGetVersion()?
• Opcode 1: XHInqTarget()?
• Opcode 2: XHReserve()?
• Opcode 3: XHLock()?
• Opcode 4: XHStop()?
• Opcode 5: XHEject()?
• Opcode 6: XHDrvMap()
• Opcode 7: XHInqDev()?
• Opcode 8: XHInqDriver()?
• Opcode 9: XHNewCookie()?
• Opcode 10: XHReadWrite()
• Opcode 11: XHInqTarget2()?
• Opcode 12: XHInqDev2()?
• Opcode 13: XHDriverSpecial()?
• Opcode 14: XHGetCapacity()?
• Opcode 15: XHMediumChanged()?
• Opcode 16: XHMiNTInfo()?
• Opcode 17: XHDOSLimits()?
• Opcode 18: XHLastAccess()?
• Opcode 19: XHReaccess()?

---