cd.device/CD_ADDCHANGEINT

[Contents] [Index] [Help] [Retrace] [Browse <] [Browse >]

---

 NAME
 CD_ADDCHANGEINT -- add a disk change software interrupt handler.
 FUNCTION
 This command lets you add a software interrupt handler to the
 disk device that gets invoked whenever a disk insertion or removal
 occurs.
 You must pass in a properly initialized Exec Interrupt structure
 and be prepared to deal with disk insertions/removals immediately.
 The interrupt is generated by the exec Cause function, so you must
 preserve A6.
 To set up the handler, an Interrupt structure must be initialized.
 This structure is supplied as the io_Data to the CD_ADDCHANGEINT
 command. The handler then gets linked into the handler chain and
 gets invoked whenever a disk change happens. You must eventually
 remove the handler before you exit.
 This command only returns when the handler is removed. That is,
 the device holds onto the IO request until the CD_REMCHANGEINT command
 is executed with that same IO request. Hence, you must use SendIO()
 with this command.
 IO REQUEST INPUT
 io_Device preset by the call to OpenDevice()
 io_Unit preset by the call to OpenDevice()
 io_Command CD_ADDCHANGEINT
 io_Length sizeof(struct Interrupt)
 io_Data pointer to Interrupt structure
 IO REQUEST RESULT
 io_Error - 0 for success, or an error code as defined in
 <devices/cd.h>
 SEE ALSO
 CD_REMCHANGEINT, <devices/cd.h>, <exec/interrupts.h>,
 exec.library/Cause()

---

[Back to Amiga Developer Docs]