Mac Dev Center Mac OS X Reference Library Drivers, Kernel, & Hardware: User-Space Device Access Disc Recording Framework Reference

Overview

Obtain information about CD/DVD burners connected to the computer.

Discussion

About Devices

A DRDevice represents a physical CD/DVD drive connected to the computer.

Obtaining Device instances

The programmer cannot directly create DRDevices. Devices are managed by the burn engine and are asked for by client code. The preferred way of obtaining an instance is by registering with the DRNotificationCenter and listening for the DRDeviceAppearedNotification . This notification is sent to all observers when a device is first detected by the burn engine (such as when a device is plugged in or turned on). A registered observer is guaranteed to receive all DRDeviceAppearedNotifications . When a client registers for the DRDeviceAppearedNotification , the engine will ensure that the client gets notified of all devices currently connected to the machine. When a device is removed, registed observers will receive a DRDeviceDisappearedNotification .

It's also possible to obtain a device instance from its IORegistry path (deviceForIORegistryEntryPath: ) or the BSD /dev node name (deviceForBSDName: ). If you have a reference to a device instance, you can determine if the physical device is still valid and connected by sending the isValid method to the instance.

Device Control

There is a limited set of operations that can be performed on a device. The most important of these is media reservation. Reserving media is a process by which applications arbitrate for blank media. An application registers interest in obtaining a media reservation by caling acquireMediaReservation and gives up its interest by calling releaseMediaReservation . Asking to acquire a reservation does not mean you will get it! Another application may already have the reservation and will refuse to give it up to you. In this case, the only thing to do is to play fair and wait until the DRDeviceMediaIsReservedKey indicates that your app has obtained the reservation.

The device tray can be opened (openTray ) or closed (closeTray ) and media can be ejected (ejectMedia).

Classes

DRDevice

Represents a CD or DVD burner connected to the computer.

Categories

DRDevice(InfoConvenience)

DRDevice(StatusConvenience)

Constants

DRDeviceAppearedNotification

DRDeviceBurnSpeedBD1x

DRDeviceBurnSpeedCD1x

DRDeviceBurnSpeedDVD1x

DRDeviceBurnSpeedHDDVD1x

DRDeviceBurnSpeedMax

DRDeviceBurnSpeedsKey

DRDeviceCanTestWriteCDKey

DRDeviceCanTestWriteDVDKey

DRDeviceCanUnderrunProtectCDKey

DRDeviceCanUnderrunProtectDVDKey

DRDeviceCanWriteBDKey

DRDeviceCanWriteBDREKey

DRDeviceCanWriteBDRKey

DRDeviceCanWriteCDKey

DRDeviceCanWriteCDRawKey

DRDeviceCanWriteCDRKey

DRDeviceCanWriteCDRWKey

DRDeviceCanWriteCDSAOKey

DRDeviceCanWriteCDTAOKey

DRDeviceCanWriteCDTextKey

DRDeviceCanWriteDVDDAOKey

DRDeviceCanWriteDVDKey

DRDeviceCanWriteDVDPlusRDoubleLayerKey

DRDeviceCanWriteDVDPlusRKey

DRDeviceCanWriteDVDPlusRWDoubleLayerKey

DRDeviceCanWriteDVDPlusRWKey

DRDeviceCanWriteDVDRAMKey

DRDeviceCanWriteDVDRDualLayerKey

DRDeviceCanWriteDVDRKey

DRDeviceCanWriteDVDRWDualLayerKey

DRDeviceCanWriteDVDRWKey

DRDeviceCanWriteHDDVDKey

DRDeviceCanWriteHDDVDRAMKey

DRDeviceCanWriteHDDVDRDualLayerKey

DRDeviceCanWriteHDDVDRKey

DRDeviceCanWriteHDDVDRWDualLayerKey

DRDeviceCanWriteHDDVDRWKey

DRDeviceCanWriteIndexPointsKey

DRDeviceCanWriteISRCKey

DRDeviceCanWriteKey

DRDeviceCurrentWriteSpeedKey

DRDeviceDisappearedNotification

DRDeviceFirmwareRevisionKey

DRDeviceIORegistryEntryPathKey

DRDeviceIsBusyKey

DRDeviceIsTrayOpenKey

DRDeviceLoadingMechanismCanEjectKey

DRDeviceLoadingMechanismCanInjectKey

DRDeviceLoadingMechanismCanOpenKey

DRDeviceMaximumWriteSpeedKey

DRDeviceMediaBlocksFreeKey

DRDeviceMediaBlocksOverwritableKey

DRDeviceMediaBlocksUsedKey

DRDeviceMediaBSDNameKey

DRDeviceMediaClassBD

DRDeviceMediaClassCD

DRDeviceMediaClassDVD

DRDeviceMediaClassHDDVD

DRDeviceMediaClassKey

DRDeviceMediaClassUnknown

DRDeviceMediaDoubleLayerL0DataZoneBlocksKey

DRDeviceMediaFreeSpaceKey

DRDeviceMediaInfoKey

DRDeviceMediaIsAppendableKey

DRDeviceMediaIsBlankKey

DRDeviceMediaIsErasableKey

DRDeviceMediaIsOverwritableKey

DRDeviceMediaIsReservedKey

DRDeviceMediaOverwritableSpaceKey

DRDeviceMediaSessionCountKey

DRDeviceMediaStateInTransition

DRDeviceMediaStateKey

DRDeviceMediaStateMediaPresent

DRDeviceMediaStateNone

DRDeviceMediaTrackCountKey

DRDeviceMediaTypeBDR

DRDeviceMediaTypeBDRE

DRDeviceMediaTypeBDROM

DRDeviceMediaTypeCDR

DRDeviceMediaTypeCDROM

DRDeviceMediaTypeCDRW

DRDeviceMediaTypeDVDPlusR

DRDeviceMediaTypeDVDPlusRDoubleLayer

DRDeviceMediaTypeDVDPlusRW

DRDeviceMediaTypeDVDPlusRWDoubleLayer

DRDeviceMediaTypeDVDR

DRDeviceMediaTypeDVDRAM

DRDeviceMediaTypeDVDRDualLayer

DRDeviceMediaTypeDVDROM

DRDeviceMediaTypeDVDRW

DRDeviceMediaTypeDVDRWDualLayer

DRDeviceMediaTypeHDDVDR

DRDeviceMediaTypeHDDVDRAM

DRDeviceMediaTypeHDDVDRDualLayer

DRDeviceMediaTypeHDDVDROM

DRDeviceMediaTypeHDDVDRW

DRDeviceMediaTypeHDDVDRWDualLayer

DRDeviceMediaTypeKey

DRDeviceMediaTypeUnknown

DRDeviceMediaUsedSpaceKey

DRDevicePhysicalInterconnectATAPI

DRDevicePhysicalInterconnectFibreChannel

DRDevicePhysicalInterconnectFireWire

DRDevicePhysicalInterconnectKey

DRDevicePhysicalInterconnectLocationExternal

DRDevicePhysicalInterconnectLocationInternal

DRDevicePhysicalInterconnectLocationKey

DRDevicePhysicalInterconnectLocationUnknown

DRDevicePhysicalInterconnectSCSI

DRDevicePhysicalInterconnectUSB

DRDeviceProductNameKey

DRDeviceStatusChangedNotification

DRDeviceSupportLevelAppleShipping

DRDeviceSupportLevelAppleSupported

DRDeviceSupportLevelKey

DRDeviceSupportLevelNone

DRDeviceSupportLevelUnsupported

DRDeviceSupportLevelVendorSupported

DRDeviceTrackInfoKey

DRDeviceTrackRefsKey

DRDeviceVendorNameKey

DRDeviceWriteBufferSizeKey

DRDeviceWriteCapabilitiesKey

extern NSString* const DRDeviceAppearedNotification;  

Discussion

Posted by a DRNotificationCenter when a device is added to the system.

This notification is registered for only by name.

The object associated with this notification is the the device that has appeared. The userInfo is the same dictionary returned by info for that device.

Availability

Introduced in Mac OS X v10.2

extern const float DRDeviceBurnSpeedBD1x;  

Discussion

4496.0 KB/sec.

Availability

Introduced in Mac OS X v10.5.

extern const float DRDeviceBurnSpeedCD1x;  

Discussion

176.4 KB/sec.

Availability

Introduced in Mac OS X v10.2

extern const float DRDeviceBurnSpeedDVD1x;  

Discussion

1385.0 KB/sec.

Availability

Introduced in Mac OS X v10.2

extern const float DRDeviceBurnSpeedHDDVD1x;  

Discussion

4568.0 KB/sec.

Availability

Introduced in Mac OS X v10.5.

extern const float DRDeviceBurnSpeedMax;  

Discussion

A value representing the maximum speed at which a device can burn. The actual speed will vary from device to device.

Availability

Introduced in Mac OS X v10.2

extern NSString* const DRDeviceBurnSpeedsKey;  

Discussion

One of the keys in the dictionary returned by the status method. NSArray containing the possible burn speeds available to use. This key may not be present if no media is inserted.

Availability

Introduced in Mac OS X v10.2

extern NSString* const DRDeviceCanTestWriteCDKey;  

Discussion

One of the keys in the DRDeviceWriteCapabilitiesKey dictionary. NSNumber containing a boolean value indicating whether the device can perform a test burn to CD media.

Availability

Introduced in Mac OS X v10.2

extern NSString* const DRDeviceCanTestWriteDVDKey;  

Discussion

One of the keys in the DRDeviceWriteCapabilitiesKey dictionary. NSNumber containing a boolean value indicating whether the device can perform a test burn to DVD media.

Availability

Introduced in Mac OS X v10.2

extern NSString* const DRDeviceCanUnderrunProtectCDKey;  

Discussion

One of the keys in the DRDeviceWriteCapabilitiesKey dictionary. NSNumber containing a boolean value indicating whether the device supports burn underrun protection when writing to CD media.

Availability

Introduced in Mac OS X v10.2

extern NSString* const DRDeviceCanUnderrunProtectDVDKey;  

Discussion

One of the keys in the DRDeviceWriteCapabilitiesKey dictionary. NSNumber containing a boolean value indicating whether the device supports burn underrun protection when writing to DVD media.

Availability

Introduced in Mac OS X v10.2

extern NSString* const DRDeviceCanWriteBDKey;  

Discussion

One of the keys in the DRDeviceWriteCapabilitiesKey dictionary. NSNumber containing a boolean value indicating whether the device can write to some type of BD (Blu-ray) based media.

Availability

Introduced in Mac OS X v10.5.

extern NSString* const DRDeviceCanWriteBDREKey;  

Discussion

One of the keys in the DRDeviceWriteCapabilitiesKey dictionary. NSNumber containing a boolean value indicating whether the device can write to BD-RE media.

Availability

Introduced in Mac OS X v10.5.

extern NSString* const DRDeviceCanWriteBDRKey;  

Discussion

One of the keys in the DRDeviceWriteCapabilitiesKey dictionary. NSNumber containing a boolean value indicating whether the device can write to BD-R media.

Availability

Introduced in Mac OS X v10.5.

extern NSString* const DRDeviceCanWriteCDKey;  

Discussion

One of the keys in the DRDeviceWriteCapabilitiesKey dictionary. NSNumber containing a boolean value indicating whether the device can write to some type of CD based media.

Availability

Introduced in Mac OS X v10.2

extern NSString* const DRDeviceCanWriteCDRawKey;  

Discussion

One of the keys in the DRDeviceWriteCapabilitiesKey dictionary. NSNumber containing a boolean value indicating whether the device supports a raw mode burn strategy for CD. Raw mode is sometimes incorrectly referred to as DAO (disc-at-once).

Availability

Introduced in Mac OS X v10.3.

extern NSString* const DRDeviceCanWriteCDRKey;  

Discussion

One of the keys in the DRDeviceWriteCapabilitiesKey dictionary. NSNumber containing a boolean value indicating whether the device can write to CD-R media.

Availability

Introduced in Mac OS X v10.2

extern NSString* const DRDeviceCanWriteCDRWKey;  

Discussion

One of the keys in the DRDeviceWriteCapabilitiesKey dictionary. NSNumber containing a boolean value indicating whether the device can write to CD-RW media.

Availability

Introduced in Mac OS X v10.2

extern NSString* const DRDeviceCanWriteCDSAOKey;  

Discussion

One of the keys in the DRDeviceWriteCapabilitiesKey dictionary. NSNumber containing a boolean value indicating whether the device supports a SAO (session-at-once) burn strategy for CD.

Availability

Introduced in Mac OS X v10.3.

extern NSString* const DRDeviceCanWriteCDTAOKey;  

Discussion

One of the keys in the DRDeviceWriteCapabilitiesKey dictionary. NSNumber containing a boolean value indicating whether the device supports a TAO (track-at-once) burn strategy for CD.

Availability

Introduced in Mac OS X v10.3.

extern NSString* const DRDeviceCanWriteCDTextKey;  

Discussion

One of the keys in the DRDeviceWriteCapabilitiesKey dictionary. NSNumber containing a boolean value indicating whether the device can write CD-Text information to media.

Availability

Introduced in Mac OS X v10.2

extern NSString* const DRDeviceCanWriteDVDDAOKey;  

Discussion

One of the keys in the DRDeviceWriteCapabilitiesKey dictionary. NSNumber containing a boolean value indicating whether the device supports a DAO (disc-at-once) burn strategy on DVD media.

Availability

Introduced in Mac OS X v10.3.

extern NSString* const DRDeviceCanWriteDVDKey;  

Discussion

One of the keys in the DRDeviceWriteCapabilitiesKey dictionary. NSNumber containing a boolean value indicating whether the device can write to some type of DVD based media.

Availability

Introduced in Mac OS X v10.2

extern NSString* const DRDeviceCanWriteDVDPlusRDoubleLayerKey;  

Discussion

One of the keys in the DRDeviceWriteCapabilitiesKey dictionary. NSNumber containing a boolean value indicating whether the device can write to DVD+R DL media.

Availability

Introduced in Mac OS X v10.4.

extern NSString* const DRDeviceCanWriteDVDPlusRKey;  

Discussion

One of the keys in the DRDeviceWriteCapabilitiesKey dictionary. NSNumber containing a boolean value indicating whether the device can write to DVD+R media.

Availability

Introduced in Mac OS X v10.3.

extern NSString* const DRDeviceCanWriteDVDPlusRWDoubleLayerKey;  

Discussion

One of the keys in the DRDeviceWriteCapabilitiesKey dictionary. NSNumber containing a boolean value indicating whether the device can write to DVD+RW DL media.

Availability

Introduced in Mac OS X v10.5.

extern NSString* const DRDeviceCanWriteDVDPlusRWKey;  

Discussion

One of the keys in the DRDeviceWriteCapabilitiesKey dictionary. NSNumber containing a boolean value indicating whether the device can write to DVD+RW media.

Availability

Introduced in Mac OS X v10.3.

extern NSString* const DRDeviceCanWriteDVDRAMKey;  

Discussion

One of the keys in the DRDeviceWriteCapabilitiesKey dictionary. NSNumber containing a boolean value indicating whether the device can write to DVD-RAM media.

Availability

Introduced in Mac OS X v10.2

extern NSString* const DRDeviceCanWriteDVDRDualLayerKey;  

Discussion

One of the keys in the DRDeviceWriteCapabilitiesKey dictionary. NSNumber containing a boolean value indicating whether the device can write to DVD-R DL media.

Availability

Introduced in Mac OS X v10.5.

extern NSString* const DRDeviceCanWriteDVDRKey;  

Discussion

One of the keys in the DRDeviceWriteCapabilitiesKey dictionary. NSNumber containing a boolean value indicating whether the device can write to DVD-R media.

Availability

Introduced in Mac OS X v10.2

extern NSString* const DRDeviceCanWriteDVDRWDualLayerKey;  

Discussion

One of the keys in the DRDeviceWriteCapabilitiesKey dictionary. NSNumber containing a boolean value indicating whether the device can write to DVD-RW DL media.

Availability

Introduced in Mac OS X v10.5.

extern NSString* const DRDeviceCanWriteDVDRWKey;  

Discussion

One of the keys in the DRDeviceWriteCapabilitiesKey dictionary. NSNumber containing a boolean value indicating whether the device can write to DVD-RW media.

Availability

Introduced in Mac OS X v10.2

extern NSString* const DRDeviceCanWriteHDDVDKey;  

Discussion

One of the keys in the DRDeviceWriteCapabilitiesKey dictionary. NSNumber containing a boolean value indicating whether the device can write to some type of HDDVD based media.

Availability

Introduced in Mac OS X v10.5.

extern NSString* const DRDeviceCanWriteHDDVDRAMKey;  

Discussion

One of the keys in the DRDeviceWriteCapabilitiesKey dictionary. NSNumber containing a boolean value indicating whether the device can write to HD DVD-RAM media.

Availability

Introduced in Mac OS X v10.5.

extern NSString* const DRDeviceCanWriteHDDVDRDualLayerKey;  

Discussion

One of the keys in the DRDeviceWriteCapabilitiesKey dictionary. NSNumber containing a boolean value indicating whether the device can write to HD DVD-R DL media.

Availability

Introduced in Mac OS X v10.5.

extern NSString* const DRDeviceCanWriteHDDVDRKey;  

Discussion

One of the keys in the DRDeviceWriteCapabilitiesKey dictionary. NSNumber containing a boolean value indicating whether the device can write to HD DVD-R media.

Availability

Introduced in Mac OS X v10.5.

extern NSString* const DRDeviceCanWriteHDDVDRWDualLayerKey;  

Discussion

One of the keys in the DRDeviceWriteCapabilitiesKey dictionary. NSNumber containing a boolean value indicating whether the device can write to HD DVD-RW DL media.

Availability

Introduced in Mac OS X v10.5.

extern NSString* const DRDeviceCanWriteHDDVDRWKey;  

Discussion

One of the keys in the DRDeviceWriteCapabilitiesKey dictionary. NSNumber containing a boolean value indicating whether the device can write to HD DVD-RW media.

Availability

Introduced in Mac OS X v10.5.

extern NSString* const DRDeviceCanWriteIndexPointsKey;  

Discussion

One of the keys in the DRDeviceWriteCapabilitiesKey dictionary. NSNumber containing a boolean value indicating whether the device can write index points to CD media.

Availability

Introduced in Mac OS X v10.3.

extern NSString* const DRDeviceCanWriteISRCKey;  

Discussion

One of the keys in the DRDeviceWriteCapabilitiesKey dictionary. NSNumber containing a boolean value indicating whether the device can write ISRC to CD media.

Availability

Introduced in Mac OS X v10.3.

extern NSString* const DRDeviceCanWriteKey;  

Discussion

One of the keys in the DRDeviceWriteCapabilitiesKey dictionary. NSNumber containing a boolean value indicating whether the device can write to some type of media.

Availability

Introduced in Mac OS X v10.2

extern NSString* const DRDeviceCurrentWriteSpeedKey;  

Discussion

One of the keys in the dictionary returned by the status method. NSNumber containing the current burning speed of this device.

Availability

Introduced in Mac OS X v10.2

extern NSString* const DRDeviceDisappearedNotification;  

Discussion

Posted by a DRNotificationCenter when a device is removed from the system.

The object associated with this notification is the the device that has disappeared. The userInfo is the same dictionary returned by info for that device.

Availability

Introduced in Mac OS X v10.2

extern NSString* const DRDeviceFirmwareRevisionKey;  

Discussion

One of the keys in the dictionary returned by the info method. NSString containing the firmeware revision extracted from the device.

Availability

Introduced in Mac OS X v10.2

extern NSString* const DRDeviceIORegistryEntryPathKey;  

Discussion

One of the keys in the dictionary returned by the info method. NSString containing the path of the device in the IO Registry.

Availability

Introduced in Mac OS X v10.2

extern NSString* const DRDeviceIsBusyKey;  

Discussion

One of the keys in the dictionary returned by the status method. NSNumber containing a boolean value indicating whether the device is busy or not.

Availability

Introduced in Mac OS X v10.2

extern NSString* const DRDeviceIsTrayOpenKey;  

Discussion

One of the keys in the dictionary returned by the status method. NSNumber containing a boolean value indicating whether the device's tray is open or not.

Availability

Introduced in Mac OS X v10.2

extern NSString* const DRDeviceLoadingMechanismCanEjectKey;  

Discussion

One of the keys in the dictionary returned by the info method. NSNumber describing if the loading mechanism of the drive can eject.

Availability

Introduced in Mac OS X v10.3.

extern NSString* const DRDeviceLoadingMechanismCanInjectKey;  

Discussion

One of the keys in the dictionary returned by the info method. NSNumber describing if the loading mechanism of the drive can inject.

Availability

Introduced in Mac OS X v10.3.

extern NSString* const DRDeviceLoadingMechanismCanOpenKey;  

Discussion

One of the keys in the dictionary returned by the info method. NSNumber describing if the loading mechanism of the drive can open.

Availability

Introduced in Mac OS X v10.3.

extern NSString* const DRDeviceMaximumWriteSpeedKey;  

Discussion

One of the keys in the dictionary returned by the status method. NSNumber containing the maximum burning speed of this device.

Availability

Introduced in Mac OS X v10.2

extern NSString* const DRDeviceMediaBlocksFreeKey;  

Discussion

One of the keys in the DRDeviceMediaInfoKey dictionary. NSNumber containing the amount of space available (in blocks) on the media to be written to. If the media already contains data and this value will be less than the normal maximum size of the disc. This value will normally only be used if the intent is to append data onto an open disc.

Availability

Introduced in Mac OS X v10.2

extern NSString* const DRDeviceMediaBlocksOverwritableKey;  

Discussion

One of the keys in the DRDeviceMediaInfoKey dictionary. NSNumber containing the total amount of writable space available (in blocks) on the media to be written to - if that media can be overwritten. Media that can be overwitten is designated through the DRDeviceMediaIsOverwritableKey .

The overwritable space is the amount of space on the disc that would be available if any data currently on the disc is first erased.

Availability

Introduced in Mac OS X v10.3.

extern NSString* const DRDeviceMediaBlocksUsedKey;  

Discussion

One of the keys in the DRDeviceMediaInfoKey dictionary. NSNumber containing the amount of space currently used (in blocks) for exising data.

Availability

Introduced in Mac OS X v10.2

extern NSString* const DRDeviceMediaBSDNameKey;  

Discussion

One of the keys in the DRDeviceMediaInfoKey dictionary. NSString containing the BSD /dev node name assigned to the media in the device.

Availability

Introduced in Mac OS X v10.2

extern NSString* const DRDeviceMediaClassBD;  

Discussion

One possible value of the DRDeviceMediaClassKey. Indicates the media is some type of BD (Blu-ray) based media.

Availability

Introduced in Mac OS X v10.5.

extern NSString* const DRDeviceMediaClassCD;  

Discussion

One possible value of the DRDeviceMediaClassKey. Indicates the media is some type of CD based media.

Availability

Introduced in Mac OS X v10.2

extern NSString* const DRDeviceMediaClassDVD;  

Discussion

One possible value of the DRDeviceMediaClassKey. Indicates the media is some type of DVD based media.

Availability

Introduced in Mac OS X v10.2

extern NSString* const DRDeviceMediaClassHDDVD;  

Discussion

One possible value of the DRDeviceMediaClassKey. Indicates the media is some type of HD DVD based media.

Availability

Introduced in Mac OS X v10.5.

extern NSString* const DRDeviceMediaClassKey;  

Discussion

One of the keys in the DRDeviceMediaInfoKey dictionary. NSString containing the class of media present in the drive.

Availability

Introduced in Mac OS X v10.2

extern NSString* const DRDeviceMediaClassUnknown;  

Discussion

One possible value of the DRDeviceMediaClassKey. Indicates the media class is unknown.

Availability

Introduced in Mac OS X v10.2

extern NSString* const DRDeviceMediaDoubleLayerL0DataZoneBlocksKey;  

Discussion

One of the keys in the DRDeviceMediaInfoKey dictionary. NSNumber containing the amount of space available (in blocks) on layer 0 of a double layer piece of media.

Availability

Introduced in Mac OS X v10.4.

extern NSString* const DRDeviceMediaFreeSpaceKey;  

Discussion

One of the keys in the DRDeviceMediaInfoKey dictionary. MSF value of the amount of space available on the media to be written to. If the media already contains data and this value will be less than the normal maximum size of the disc. This value will normally only be used if the intent is to append data onto an open disc.

Availability

Introduced in Mac OS X v10.2

extern NSString* const DRDeviceMediaInfoKey;  

Discussion

One of the keys in the dictionary returned by the status method. NSDictionary of information describing the media currently in the device. This key may not be present if no media is inserted.

Availability

Introduced in Mac OS X v10.2

extern NSString* const DRDeviceMediaIsAppendableKey;  

Discussion

One of the keys in the DRDeviceMediaInfoKey dictionary. NSNumber containing a boolean value indicating that data can be appended to the exisiting data (if any).

Availability

Introduced in Mac OS X v10.2

extern NSString* const DRDeviceMediaIsBlankKey;  

Discussion

One of the keys in the DRDeviceMediaInfoKey dictionary. NSNumber containing a boolean value indicating whether data has previously been written to the media.

Availability

Introduced in Mac OS X v10.2

extern NSString* const DRDeviceMediaIsErasableKey;  

Discussion

One of the keys in the DRDeviceMediaInfoKey dictionary. NSNumber containing a boolean value indicating whether this media can be erased.

Availability

Introduced in Mac OS X v10.2

extern NSString* const DRDeviceMediaIsOverwritableKey;  

Discussion

One of the keys in the DRDeviceMediaInfoKey dictionary. NSNumber containing a boolean value indicating that the data on the disc (if any) can be overwritten. Rewritable media can always be erased, and then rewritten in its entirety, so it is always considered overwritable.

Write-once media, if its blank, can also be written in its entirety and is also considered overwritable.

Write-once media, that has been partially written, can never again enter a state where it is entirely writable and will have lost its overwritable designation.

Availability

Introduced in Mac OS X v10.3.

extern NSString* const DRDeviceMediaIsReservedKey;  

Discussion

One of the keys in the DRDeviceMediaInfoKey dictionary. NSNumber containing a boolean value indicating whether the media is reserved for exclusive use by the current process.

Availability

Introduced in Mac OS X v10.2

extern NSString* const DRDeviceMediaOverwritableSpaceKey;  

Discussion

One of the keys in the DRDeviceMediaInfoKey dictionary. MSF value of the amount of writable space available on the media to be written to - if that media can be overwritten. Media that can be overwitten is designated through the DRDeviceMediaIsOverwritableKey .

The overwritable space is the amount of space on the disc that would be available if any data currently on the disc is first erased.

Availability

Introduced in Mac OS X v10.3.

extern NSString* const DRDeviceMediaSessionCountKey;  

Discussion

One of the keys in the DRDeviceMediaInfoKey dictionary. NSNumber containing the current number of sessions present on the media.

Availability

Introduced in Mac OS X v10.2

extern NSString* const DRDeviceMediaStateInTransition;  

Discussion

One of the possible values for the DRDeviceMediaStateKey. The media is transitioning from one state to another (i.e., being spun up/down).

Availability

Introduced in Mac OS X v10.2

extern NSString* const DRDeviceMediaStateKey;  

Discussion

One of the keys in the dictionary returned by the status method. NSString describing the state of the media.

Availability

Introduced in Mac OS X v10.2

extern NSString* const DRDeviceMediaStateMediaPresent;  

Discussion

One of the possible values for the DRDeviceMediaStateKey. Device contains media of some type.

Availability

Introduced in Mac OS X v10.2

extern NSString* const DRDeviceMediaStateNone;  

Discussion

One of the possible values for the DRDeviceMediaStateKey. No media is present in the device.

Availability

Introduced in Mac OS X v10.2

extern NSString* const DRDeviceMediaTrackCountKey;  

Discussion

One of the keys in the DRDeviceMediaInfoKey dictionary. NSNumber containing the number of tracks present on the media.

Availability

Introduced in Mac OS X v10.2

extern NSString* const DRDeviceMediaTypeBDR;  

Discussion

One of the possible values of the DRDeviceMediaTypeKey. Media is a BD-R.

Availability

Introduced in Mac OS X v10.5.

extern NSString* const DRDeviceMediaTypeBDRE;  

Discussion

One of the possible values of the DRDeviceMediaTypeKey. Media is a BD-RE.

Availability

Introduced in Mac OS X v10.5.

extern NSString* const DRDeviceMediaTypeBDROM;  

Discussion

One of the possible values of the DRDeviceMediaTypeKey. Media is a BD-ROM.

Availability

Introduced in Mac OS X v10.5.

extern NSString* const DRDeviceMediaTypeCDR;  

Discussion

One of the possible values of the DRDeviceMediaTypeKey. Media is a CD-R.

Availability

Introduced in Mac OS X v10.2

extern NSString* const DRDeviceMediaTypeCDROM;  

Discussion

One of the possible values of the DRDeviceMediaTypeKey. Media is a CD-ROM.

Availability

Introduced in Mac OS X v10.2

extern NSString* const DRDeviceMediaTypeCDRW;  

Discussion

One of the possible values of the DRDeviceMediaTypeKey. Media is a CD-RW.

Availability

Introduced in Mac OS X v10.2

extern NSString* const DRDeviceMediaTypeDVDPlusR;  

Discussion

One of the possible values of the DRDeviceMediaTypeKey. Media is a DVD+R.

Availability

Introduced in Mac OS X v10.3.

extern NSString* const DRDeviceMediaTypeDVDPlusRDoubleLayer;  

Discussion

One of the possible values of the DRDeviceMediaTypeKey. Media is a DVD+R Double Layer.

Availability

Introduced in Mac OS X v10.4.

extern NSString* const DRDeviceMediaTypeDVDPlusRW;  

Discussion

One of the possible values of the DRDeviceMediaTypeKey. Media is a DVD+RW.

Availability

Introduced in Mac OS X v10.3.

extern NSString* const DRDeviceMediaTypeDVDPlusRWDoubleLayer;  

Discussion

One of the possible values of the DRDeviceMediaTypeKey. Media is a DVD+RW Double Layer.

Availability

Introduced in Mac OS X v10.5.

extern NSString* const DRDeviceMediaTypeDVDR;  

Discussion

One of the possible values of the DRDeviceMediaTypeKey. Media is a DVD-R.

Availability

Introduced in Mac OS X v10.2

extern NSString* const DRDeviceMediaTypeDVDRAM;  

Discussion

One of the possible values of the DRDeviceMediaTypeKey. Media is a DVD-RAM.

Availability

Introduced in Mac OS X v10.2

extern NSString* const DRDeviceMediaTypeDVDRDualLayer;  

Discussion

One of the possible values of the DRDeviceMediaTypeKey. Media is a DVD-R DL.

Availability

Introduced in Mac OS X v10.5.

extern NSString* const DRDeviceMediaTypeDVDROM;  

Discussion

One of the possible values of the DRDeviceMediaTypeKey. Media is a DVD-ROM.

Availability

Introduced in Mac OS X v10.2

extern NSString* const DRDeviceMediaTypeDVDRW;  

Discussion

One of the possible values of the DRDeviceMediaTypeKey. Media is a DVD-RW.

Availability

Introduced in Mac OS X v10.2

extern NSString* const DRDeviceMediaTypeDVDRWDualLayer;  

Discussion

One of the possible values of the DRDeviceMediaTypeKey. Media is a DVD-RW DL.

Availability

Introduced in Mac OS X v10.5.

extern NSString* const DRDeviceMediaTypeHDDVDR;  

Discussion

One of the possible values of the DRDeviceMediaTypeKey. Media is a HD DVD-R.

Availability

Introduced in Mac OS X v10.5.

extern NSString* const DRDeviceMediaTypeHDDVDRAM;  

Discussion

One of the possible values of the DRDeviceMediaTypeKey. Media is a HD DVD-RAM.

Availability

Introduced in Mac OS X v10.5.

extern NSString* const DRDeviceMediaTypeHDDVDRDualLayer;  

Discussion

One of the possible values of the DRDeviceMediaTypeKey. Media is a HD DVD-R DL.

Availability

Introduced in Mac OS X v10.5.

extern NSString* const DRDeviceMediaTypeHDDVDROM;  

Discussion

One of the possible values of the DRDeviceMediaTypeKey. Media is a HD DVD-ROM.

Availability

Introduced in Mac OS X v10.5.

extern NSString* const DRDeviceMediaTypeHDDVDRW;  

Discussion

One of the possible values of the DRDeviceMediaTypeKey. Media is a HD DVD-RW.

Availability

Introduced in Mac OS X v10.5.

extern NSString* const DRDeviceMediaTypeHDDVDRWDualLayer;  

Discussion

One of the possible values of the DRDeviceMediaTypeKey. Media is a HD DVD-RW DL.

Availability

Introduced in Mac OS X v10.5.

extern NSString* const DRDeviceMediaTypeKey;  

Discussion

One of the keys in the DRDeviceMediaInfoKey dictionary. NSString containing the type of media inserted in the device.

Availability

Introduced in Mac OS X v10.2

extern NSString* const DRDeviceMediaTypeUnknown;  

Discussion

One of the possible values of the DRDeviceMediaTypeKey. The type of the media cannot be determined.

Availability

Introduced in Mac OS X v10.2

extern NSString* const DRDeviceMediaUsedSpaceKey;  

Discussion

One of the keys in the DRDeviceMediaInfoKey dictionary. MSF value of the amount of space currently used for exising data.

Availability

Introduced in Mac OS X v10.2

extern NSString* const DRDevicePhysicalInterconnectATAPI;  

Discussion

One of the possible values of the DRDevicePhysicalInterconnectKey. Device is connected on an ATAPI interface.

Availability

Introduced in Mac OS X v10.2

extern NSString* const DRDevicePhysicalInterconnectFibreChannel;  

Discussion

One of the possible values of the DRDevicePhysicalInterconnectKey. Device is connected through a Fibre Channel interface.

Availability

Introduced in Mac OS X v10.3.

extern NSString* const DRDevicePhysicalInterconnectFireWire;  

Discussion

One of the possible values of the DRDevicePhysicalInterconnectKey. Device is connected through a Firewire interface.

Availability

Introduced in Mac OS X v10.2

extern NSString* const DRDevicePhysicalInterconnectKey;  

Discussion

One of the keys in the dictionary returned by the info method. NSString describing the connection of the device to the computer.

Availability

Introduced in Mac OS X v10.2

extern NSString* const DRDevicePhysicalInterconnectLocationExternal;  

Discussion

One of the possible values of the DRDevicePhysicalInterconnectLocationKey. Device is connected to the machine externally.

Availability

Introduced in Mac OS X v10.2

extern NSString* const DRDevicePhysicalInterconnectLocationInternal;  

Discussion

One of the possible values of the DRDevicePhysicalInterconnectLocationKey. Device is connected to the machine internally.

Availability

Introduced in Mac OS X v10.2

extern NSString* const DRDevicePhysicalInterconnectLocationKey;  

Discussion

One of the keys in the dictionary returned by the info method. NSString describing the location of the device (e.g. internal/external).

Availability

Introduced in Mac OS X v10.2

extern NSString* const DRDevicePhysicalInterconnectLocationUnknown;  

Discussion

One of the possible values of the DRDevicePhysicalInterconnectLocationKey. It's not known how the device is connected.

Availability

Introduced in Mac OS X v10.2

extern NSString* const DRDevicePhysicalInterconnectSCSI;  

Discussion

One of the possible values of the DRDevicePhysicalInterconnectKey. Device is connected on a SCSI interface.

Availability

Introduced in Mac OS X v10.2

extern NSString* const DRDevicePhysicalInterconnectUSB;  

Discussion

One of the possible values of the DRDevicePhysicalInterconnectKey. Device is connected through a USB interface.

Availability

Introduced in Mac OS X v10.2

extern NSString* const DRDeviceProductNameKey;  

Discussion

One of the keys in the dictionary returned by the info method. NSString containing the product name extracted from the device.

Availability

Introduced in Mac OS X v10.2

extern NSString* const DRDeviceStatusChangedNotification;  

Discussion

Posted by a DRNotificationCenter when the media in a device changes state. This can include being ejected, inserted, becoming busy, etc.

The object for this notification is the device who's media is changing state. The userInfo for this notification is the same dictionary returned by status for that device.

Availability

Introduced in Mac OS X v10.2

extern NSString* const DRDeviceSupportLevelAppleShipping;  

Discussion

One of the values for DRDeviceSupportLevelKey. This value indicates this device is shipping in some Apple machine.

Availability

Introduced in Mac OS X v10.2

extern NSString* const DRDeviceSupportLevelAppleSupported;  

Discussion

One of the values for DRDeviceSupportLevelKey. This value indicates this device has been tested by Apple for support.

Availability

Introduced in Mac OS X v10.2

extern NSString* const DRDeviceSupportLevelKey;  

Discussion

One of the keys in the dictionary returned by the info method. NSString describing the support level the device enjoys from the engine.

Availability

Introduced in Mac OS X v10.2

extern NSString* const DRDeviceSupportLevelNone;  

Discussion

One of the values for DRDeviceSupportLevelKey. This value indicates this device is not supported.

Availability

Introduced in Mac OS X v10.2

extern NSString* const DRDeviceSupportLevelUnsupported;  

Discussion

One of the values for DRDeviceSupportLevelKey. This value indicates the device is unsupported, but the engine will try to use it anyway.

Availability

Introduced in Mac OS X v10.3.

extern NSString* const DRDeviceSupportLevelVendorSupported;  

Discussion

One of the values for DRDeviceSupportLevelKey. This value indicates this device has been tested by a third party for support.

Availability

Introduced in Mac OS X v10.2

extern NSString* const DRDeviceTrackInfoKey;  

Discussion

One of the keys in the dictionary returned by the status method. NSDictionary containing NSDictionaries describing the tracks. DRTracks from the DRDeviceTrackRefsKey are used as keys into this dictionary.

Availability

Introduced in Mac OS X v10.3.

extern NSString* const DRDeviceTrackRefsKey;  

Discussion

One of the keys in the dictionary returned by the status method. NSArray containing a list of DRTrack objects describing any tracks that are already on the disc.

Availability

Introduced in Mac OS X v10.3.

extern NSString* const DRDeviceVendorNameKey;  

Discussion

One of the keys in the dictionary returned by the info method. NSString containing the vendor name extracted from the device.

Availability

Introduced in Mac OS X v10.2

extern NSString* const DRDeviceWriteBufferSizeKey;  

Discussion

One of the keys in the dictionary returned by the info method. NSNumber containing the size of the write buffer of the device.

Availability

Introduced in Mac OS X v10.3.

extern NSString* const DRDeviceWriteCapabilitiesKey;  

Discussion

One of the keys in the dictionary returned by the info method. NSDictionary containing the capabilities of the device for writing different kinds of media.

Availability

Introduced in Mac OS X v10.2