Important: This document is part of the Legacy section of the ADC Reference Library. This information should not be used for new development.
Current information on this Reference Library topic can be found here:
|
Q: The A: This event notifies clients when an ATA or ATAPI device becomes available for use. The event occurs either when a new device is connected to the bus or when a previously unavailable device becomes available again (as in system wakeup when power is restored to the device).
If the device has a registered driver, only that driver will be notified of the
event; otherwise, each registered default driver will be notified until a
driver responds favorably (a Drivers should keep track of whether the device coming online is a newly connected device or one which is currently offline (connected but not unavailable). A device should be considered connected until a kATARemovedEvent for the device occurs.
This event notifies the registered driver of an ATA or ATAPI device that the device is now unavailable for use (offline). The device, however, is still connected to the bus and the offline state is assumed to be temporary. This event will occur at system sleep when power is removed.
Currently, this event is generated only when the ATA Manager receives a
This event notifies the registered driver of an ATA or ATAPI device that the
device has been removed. The removal may be either controlled (e.g., a software
eject command to the ATA Manager) or uncontrolled (e.g., a forced removal by
the user). Note the device may have been in either an online or offline state
prior to the removal. If the device state was online prior to the removal a
This event notifies the registered driver of an ATA or ATAPI device that the device has been reset. The device may need to be reconfigured by the driver before it can be used again. This event was created for use with multiple devices per bus (ATA Master/Slave mode), since reset applies to all devices on the bus and not a specific device. At this time Apple does not implement multiple devices per bus with ATA and this event has not been implemented. It is advised, however, that drivers support this event now to prevent problems later on when the event is implemented.
This event is obsolete. It was defined for the early stages of the PC Card
Manager which would echo the Power Manager Sleep events to its clients. The ATA
Manager would in turn echo the request to its clients. This event was akin to
the
This event notifies the registered driver of an ATA or ATAPI device that a
request has been made to eject the device. If the response to the request is 0
the device will be ejected and a subsequent The event is defined as a protection mechanism to alert drivers of a pending ejection. Drivers will most likely want to reject the request unless it initiated the request since ejection will remove the device from the bus.
Note also that the |