Revised by: Sérgio J. Henriques, Jan. 1997
Written by: Chris Brown, Neil Day, and Brian Bechtel, May 1993
This Technical Note discusses the public interface to the Apple CD-ROM driver. This information supersedes the "Macintosh CD-ROM Device Driver" chapter of the AppleCD SC Developer's Guide available through APDA. If you're writing special purpose application software that needs to access the audio or data portions of a CD-ROM directly, this note will be of interest to you.
Changes since May 1994: Added power management and play list calls and an icon for CD-Extra discs, available starting in version 5.1.X of the Apple CD-ROM driver extension. Removed SCSI-specific calls and support for block sizes of 256 and 1024 bytes/block, which are not available starting in version 5.2.X of the Apple CD-ROM driver extension. Fixed the definition of the "CD Features" flags in GetCDFeatures. Corrected some minor errors.
This Technical Note describes version 4.0.X through version 5.2.X of the Apple CD-ROM driver. Previous versions of the Apple CD-ROM driver are documented in the "AppleCD SC Developer's Guide" from APDA.
Version 5.2.X History: Version 5.2 adds support for ATAPI CD-ROM drives.
Version 5.1.X History: Version 5.1 adds support for the AppleCD 600, support for multi-session CDs, support for an independent icon for CD-Extra, support for asynchronous calls, and support for playing audio track lists with 5 new calls: SetTrackList, GetTrackList, GetTrackIndex, SetPlayMode, and GetPlayMode.
Version 5.0.X History: Version 5.0 adds support for the AppleCD 300 Plus and three new calls: DriverGestalt, ReturnDeviceIdent, and GetCDFeatures. Version 5.0 is also the first version to support asynchronous I/O using SCSI Manager 4.3. The ReadMCN and ReadISRC calls did not return the correct information in version 4.0.X when using an AppleCD 300. Those two calls now work in version 5.0, but the format of the returned parameters has changed for all drives. Version 5.0.1 fixes the following problems: an empty tray can be ejected using the Eject control call; when third-party SCSI accelerator cards are installed, the driver now sees the CD-ROM drives and the WhoIsThere call works correctly; DriverGestalt will no longer modify csParam[0].
Version 4.0.X History: Version 4.0 of the Apple CD-ROM extension was the first version to support dual-speed operation and multiple-session Photo CDs on the AppleCD 300. Version 4.0 also supports single-session Photo CDs on all other Apple CD-ROM drives. Version 4.0 had problems with certain CD-ROMs that used encryption technology to restrict access to files. When the customer was given a decryption key to gain access to a file, the file would not always appear in the Finder. Version 4.0.1 was produced to fix this problem. This version was only tested on the Macintosh IIvx and Performa 600. Version 4.0.2 was tested on all Macintosh computers. A few changes were made to ensure compatibility across the Macintosh product line. Version 4.0.2 corrected problems when sending audio commands using block addressing only. Audio calls using minute-second-frame addressing continued to work correctly.
Audio compact discs and CD-ROM discs conform to two standards, called the Red Book and the Yellow Book. The Red book specifies audio standards; the Yellow book specifies additional standards for CD-ROM. "Red Book" is the common name of the "Compact Disc Digital Audio Standard" standard, CEI IEC 908. When a disc conforms to the red book standard, it will usually have "digital audio" printed below the "disc" logo. Most music CDs conform to this standard. "Yellow Book" is the standard for CD-ROM, ISO 10149. When a disc conforms to the yellow book, it will usually say "data storage" beneath the "disc" logo.
There are several other standards usually associated with CD-ROM technology. The "Green Book" standard defines CD-I (Compact Disc Interactive); "Orange Book" defines write-once compact discs; and "Blue Book" defines CD-Extra (Compact Disc Digital Audio plus Data).
You can get the Red Book and Yellow Book from
ANSI
Attn: Sales
1430 Broadway
New York, NY 10018
(212) 642-4900
<http://www.ansi.org/>Red Book: CEI IEC 908
Yellow Book: ISO 10149:1989
You can get the Green Book from
American CD-I Association
11111 Santa Monica, Suite 750
Los Angeles, CA 90025
(213) 444-6619
The other standards are available only to Sony/Philips licensees. Contact Sony or Philips for licensing details.
Important: This is only the introductory section of the Technote. The complete version, including an exhaustive listing of available driver calls, parameters and error listings, is available here as a downloadable Acrobat file. If you're a CD-ROM driver writer or developer, you need to download this PDF file in order to obtain the latest information on accessing the audio or data portions of a CD-ROM directly. Again, the information in this Note supersedes the Macintosh CD-ROM Device Driver chapter of the AppleCD SC Developer's Guide. |
Tech Support
Technotes
Previous Technote |
Contents |
Next Technote
Main | Top of Section | What's New | Apple Computer, Inc. | Find It | Feedback | Help