DRDevice.h Reference

Declared in
DRDevice.h

Overview

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

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 ).

Included Headers

  • <Foundation/Foundation.h>

  • <DiscRecording/DRCoreDevice.h>

  • <DiscRecording/DRMSF.h>

  • <AvailabilityMacros.h>

Constants

See the Overview section above for header-level documentation.

Global Constants

extern NSString* const DRDeviceAppearedNotification;
extern const float DRDeviceBurnSpeedBD1x;
extern const float DRDeviceBurnSpeedCD1x;
extern const float DRDeviceBurnSpeedDVD1x;
extern const float DRDeviceBurnSpeedHDDVD1x;
extern const float DRDeviceBurnSpeedMax;
extern NSString* const DRDeviceBurnSpeedsKey;
extern NSString* const DRDeviceCanTestWriteCDKey;
extern NSString* const DRDeviceCanTestWriteDVDKey;
extern NSString* const DRDeviceCanUnderrunProtectCDKey;
extern NSString* const DRDeviceCanUnderrunProtectDVDKey;
extern NSString* const DRDeviceCanWriteBDKey;
extern NSString* const DRDeviceCanWriteBDREKey;
extern NSString* const DRDeviceCanWriteBDRKey;
extern NSString* const DRDeviceCanWriteCDKey;
extern NSString* const DRDeviceCanWriteCDRawKey;
extern NSString* const DRDeviceCanWriteCDRKey;
extern NSString* const DRDeviceCanWriteCDRWKey;
extern NSString* const DRDeviceCanWriteCDSAOKey;
extern NSString* const DRDeviceCanWriteCDTAOKey;
extern NSString* const DRDeviceCanWriteCDTextKey;
extern NSString* const DRDeviceCanWriteDVDDAOKey;
extern NSString* const DRDeviceCanWriteDVDKey;
extern NSString* const DRDeviceCanWriteDVDPlusRDoubleLayerKey;
extern NSString* const DRDeviceCanWriteDVDPlusRKey;
extern NSString* const DRDeviceCanWriteDVDPlusRWDoubleLayerKey;
extern NSString* const DRDeviceCanWriteDVDPlusRWKey;
extern NSString* const DRDeviceCanWriteDVDRAMKey;
extern NSString* const DRDeviceCanWriteDVDRDualLayerKey;
extern NSString* const DRDeviceCanWriteDVDRKey;
extern NSString* const DRDeviceCanWriteDVDRWDualLayerKey;
extern NSString* const DRDeviceCanWriteDVDRWKey;
extern NSString* const DRDeviceCanWriteHDDVDKey;
extern NSString* const DRDeviceCanWriteHDDVDRAMKey;
extern NSString* const DRDeviceCanWriteHDDVDRDualLayerKey;
extern NSString* const DRDeviceCanWriteHDDVDRKey;
extern NSString* const DRDeviceCanWriteHDDVDRWDualLayerKey;
extern NSString* const DRDeviceCanWriteHDDVDRWKey;
extern NSString* const DRDeviceCanWriteIndexPointsKey;
extern NSString* const DRDeviceCanWriteISRCKey;
extern NSString* const DRDeviceCanWriteKey;
extern NSString* const DRDeviceCurrentWriteSpeedKey;
extern NSString* const DRDeviceDisappearedNotification;
extern NSString* const DRDeviceFirmwareRevisionKey;
extern NSString* const DRDeviceIORegistryEntryPathKey;
extern NSString* const DRDeviceIsBusyKey;
extern NSString* const DRDeviceIsTrayOpenKey;
extern NSString* const DRDeviceLoadingMechanismCanEjectKey;
extern NSString* const DRDeviceLoadingMechanismCanInjectKey;
extern NSString* const DRDeviceLoadingMechanismCanOpenKey;
extern NSString* const DRDeviceMaximumWriteSpeedKey;
extern NSString* const DRDeviceMediaBlocksFreeKey;
extern NSString* const DRDeviceMediaBlocksOverwritableKey;
extern NSString* const DRDeviceMediaBlocksUsedKey;
extern NSString* const DRDeviceMediaBSDNameKey;
extern NSString* const DRDeviceMediaClassBD;
extern NSString* const DRDeviceMediaClassCD;
extern NSString* const DRDeviceMediaClassDVD;
extern NSString* const DRDeviceMediaClassHDDVD;
extern NSString* const DRDeviceMediaClassKey;
extern NSString* const DRDeviceMediaClassUnknown;
extern NSString* const DRDeviceMediaDoubleLayerL0DataZoneBlocksKey;
extern NSString* const DRDeviceMediaFreeSpaceKey;
extern NSString* const DRDeviceMediaInfoKey;
extern NSString* const DRDeviceMediaIsAppendableKey;
extern NSString* const DRDeviceMediaIsBlankKey;
extern NSString* const DRDeviceMediaIsErasableKey;
extern NSString* const DRDeviceMediaIsOverwritableKey;
extern NSString* const DRDeviceMediaIsReservedKey;
extern NSString* const DRDeviceMediaOverwritableSpaceKey;
extern NSString* const DRDeviceMediaSessionCountKey;
extern NSString* const DRDeviceMediaStateInTransition;
extern NSString* const DRDeviceMediaStateKey;
extern NSString* const DRDeviceMediaStateMediaPresent;
extern NSString* const DRDeviceMediaStateNone;
extern NSString* const DRDeviceMediaTrackCountKey;
extern NSString* const DRDeviceMediaTypeBDR;
extern NSString* const DRDeviceMediaTypeBDRE;
extern NSString* const DRDeviceMediaTypeBDROM;
extern NSString* const DRDeviceMediaTypeCDR;
extern NSString* const DRDeviceMediaTypeCDROM;
extern NSString* const DRDeviceMediaTypeCDRW;
extern NSString* const DRDeviceMediaTypeDVDPlusR;
extern NSString* const DRDeviceMediaTypeDVDPlusRDoubleLayer;
extern NSString* const DRDeviceMediaTypeDVDPlusRW;
extern NSString* const DRDeviceMediaTypeDVDPlusRWDoubleLayer;
extern NSString* const DRDeviceMediaTypeDVDR;
extern NSString* const DRDeviceMediaTypeDVDRAM;
extern NSString* const DRDeviceMediaTypeDVDRDualLayer;
extern NSString* const DRDeviceMediaTypeDVDROM;
extern NSString* const DRDeviceMediaTypeDVDRW;
extern NSString* const DRDeviceMediaTypeDVDRWDualLayer;
extern NSString* const DRDeviceMediaTypeHDDVDR;
extern NSString* const DRDeviceMediaTypeHDDVDRAM;
extern NSString* const DRDeviceMediaTypeHDDVDRDualLayer;
extern NSString* const DRDeviceMediaTypeHDDVDROM;
extern NSString* const DRDeviceMediaTypeHDDVDRW;
extern NSString* const DRDeviceMediaTypeHDDVDRWDualLayer;
extern NSString* const DRDeviceMediaTypeKey;
extern NSString* const DRDeviceMediaTypeUnknown;
extern NSString* const DRDeviceMediaUsedSpaceKey;
extern NSString* const DRDevicePhysicalInterconnectATAPI;
extern NSString* const DRDevicePhysicalInterconnectFibreChannel;
extern NSString* const DRDevicePhysicalInterconnectFireWire;
extern NSString* const DRDevicePhysicalInterconnectKey;
extern NSString* const DRDevicePhysicalInterconnectLocationExternal;
extern NSString* const DRDevicePhysicalInterconnectLocationInternal;
extern NSString* const DRDevicePhysicalInterconnectLocationKey;
extern NSString* const DRDevicePhysicalInterconnectLocationUnknown;
extern NSString* const DRDevicePhysicalInterconnectSCSI;
extern NSString* const DRDevicePhysicalInterconnectUSB;
extern NSString* const DRDeviceProductNameKey;
extern NSString* const DRDeviceStatusChangedNotification;
extern NSString* const DRDeviceSupportLevelAppleShipping;
extern NSString* const DRDeviceSupportLevelAppleSupported;
extern NSString* const DRDeviceSupportLevelKey;
extern NSString* const DRDeviceSupportLevelNone;
extern NSString* const DRDeviceSupportLevelUnsupported;
extern NSString* const DRDeviceSupportLevelVendorSupported;
extern NSString* const DRDeviceTrackInfoKey;
extern NSString* const DRDeviceTrackRefsKey;
extern NSString* const DRDeviceVendorNameKey;
extern NSString* const DRDeviceWriteBufferSizeKey;
extern NSString* const DRDeviceWriteCapabilitiesKey;
Constants
DRDeviceAppearedNotification

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.

Available in OS X v10.2 and later.

Declared in DRDevice.h.

DRDeviceBurnSpeedBD1x

4496.0 KB/sec.

Available in OS X v10.5 and later.

Declared in DRDevice.h.

DRDeviceBurnSpeedCD1x

176.4 KB/sec.

Available in OS X v10.2 and later.

Declared in DRDevice.h.

DRDeviceBurnSpeedDVD1x

1385.0 KB/sec.

Available in OS X v10.2 and later.

Declared in DRDevice.h.

DRDeviceBurnSpeedHDDVD1x

4568.0 KB/sec.

Available in OS X v10.5 and later.

Declared in DRDevice.h.

DRDeviceBurnSpeedMax

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

Available in OS X v10.2 and later.

Declared in DRDevice.h.

DRDeviceBurnSpeedsKey

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.

Available in OS X v10.2 and later.

Declared in DRDevice.h.

DRDeviceCanTestWriteCDKey

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.

Available in OS X v10.2 and later.

Declared in DRDevice.h.

DRDeviceCanTestWriteDVDKey

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.

Available in OS X v10.2 and later.

Declared in DRDevice.h.

DRDeviceCanUnderrunProtectCDKey

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.

Available in OS X v10.2 and later.

Declared in DRDevice.h.

DRDeviceCanUnderrunProtectDVDKey

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.

Available in OS X v10.2 and later.

Declared in DRDevice.h.

DRDeviceCanWriteBDKey

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.

Available in OS X v10.5 and later.

Declared in DRDevice.h.

DRDeviceCanWriteBDREKey

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

Available in OS X v10.5 and later.

Declared in DRDevice.h.

DRDeviceCanWriteBDRKey

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

Available in OS X v10.5 and later.

Declared in DRDevice.h.

DRDeviceCanWriteCDKey

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.

Available in OS X v10.2 and later.

Declared in DRDevice.h.

DRDeviceCanWriteCDRawKey

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).

Available in OS X v10.3 and later.

Declared in DRDevice.h.

DRDeviceCanWriteCDRKey

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

Available in OS X v10.2 and later.

Declared in DRDevice.h.

DRDeviceCanWriteCDRWKey

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

Available in OS X v10.2 and later.

Declared in DRDevice.h.

DRDeviceCanWriteCDSAOKey

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.

Available in OS X v10.3 and later.

Declared in DRDevice.h.

DRDeviceCanWriteCDTAOKey

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.

Available in OS X v10.3 and later.

Declared in DRDevice.h.

DRDeviceCanWriteCDTextKey

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

Available in OS X v10.2 and later.

Declared in DRDevice.h.

DRDeviceCanWriteDVDDAOKey

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.

Available in OS X v10.3 and later.

Declared in DRDevice.h.

DRDeviceCanWriteDVDKey

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.

Available in OS X v10.2 and later.

Declared in DRDevice.h.

DRDeviceCanWriteDVDPlusRDoubleLayerKey

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

Available in OS X v10.4 and later.

Declared in DRDevice.h.

DRDeviceCanWriteDVDPlusRKey

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

Available in OS X v10.3 and later.

Declared in DRDevice.h.

DRDeviceCanWriteDVDPlusRWDoubleLayerKey

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

Available in OS X v10.5 and later.

Declared in DRDevice.h.

DRDeviceCanWriteDVDPlusRWKey

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

Available in OS X v10.3 and later.

Declared in DRDevice.h.

DRDeviceCanWriteDVDRAMKey

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

Available in OS X v10.2 and later.

Declared in DRDevice.h.

DRDeviceCanWriteDVDRDualLayerKey

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

Available in OS X v10.5 and later.

Declared in DRDevice.h.

DRDeviceCanWriteDVDRKey

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

Available in OS X v10.2 and later.

Declared in DRDevice.h.

DRDeviceCanWriteDVDRWDualLayerKey

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

Available in OS X v10.5 and later.

Declared in DRDevice.h.

DRDeviceCanWriteDVDRWKey

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

Available in OS X v10.2 and later.

Declared in DRDevice.h.

DRDeviceCanWriteHDDVDKey

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.

Available in OS X v10.5 and later.

Declared in DRDevice.h.

DRDeviceCanWriteHDDVDRAMKey

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

Available in OS X v10.5 and later.

Declared in DRDevice.h.

DRDeviceCanWriteHDDVDRDualLayerKey

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.

Available in OS X v10.5 and later.

Declared in DRDevice.h.

DRDeviceCanWriteHDDVDRKey

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

Available in OS X v10.5 and later.

Declared in DRDevice.h.

DRDeviceCanWriteHDDVDRWDualLayerKey

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.

Available in OS X v10.5 and later.

Declared in DRDevice.h.

DRDeviceCanWriteHDDVDRWKey

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

Available in OS X v10.5 and later.

Declared in DRDevice.h.

DRDeviceCanWriteIndexPointsKey

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

Available in OS X v10.3 and later.

Declared in DRDevice.h.

DRDeviceCanWriteISRCKey

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

Available in OS X v10.3 and later.

Declared in DRDevice.h.

DRDeviceCanWriteKey

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

Available in OS X v10.2 and later.

Declared in DRDevice.h.

DRDeviceCurrentWriteSpeedKey

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

Available in OS X v10.2 and later.

Declared in DRDevice.h.

DRDeviceDisappearedNotification

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.

Available in OS X v10.2 and later.

Declared in DRDevice.h.

DRDeviceFirmwareRevisionKey

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

Available in OS X v10.2 and later.

Declared in DRDevice.h.

DRDeviceIORegistryEntryPathKey

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

Available in OS X v10.2 and later.

Declared in DRDevice.h.

DRDeviceIsBusyKey

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.

Available in OS X v10.2 and later.

Declared in DRDevice.h.

DRDeviceIsTrayOpenKey

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.

Available in OS X v10.2 and later.

Declared in DRDevice.h.

DRDeviceLoadingMechanismCanEjectKey

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

Available in OS X v10.3 and later.

Declared in DRDevice.h.

DRDeviceLoadingMechanismCanInjectKey

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

Available in OS X v10.3 and later.

Declared in DRDevice.h.

DRDeviceLoadingMechanismCanOpenKey

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

Available in OS X v10.3 and later.

Declared in DRDevice.h.

DRDeviceMaximumWriteSpeedKey

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

Available in OS X v10.2 and later.

Declared in DRDevice.h.

DRDeviceMediaBlocksFreeKey

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.

Available in OS X v10.2 and later.

Declared in DRDevice.h.

DRDeviceMediaBlocksOverwritableKey

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.

Available in OS X v10.3 and later.

Declared in DRDevice.h.

DRDeviceMediaBlocksUsedKey

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

Available in OS X v10.2 and later.

Declared in DRDevice.h.

DRDeviceMediaBSDNameKey

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

Available in OS X v10.2 and later.

Declared in DRDevice.h.

DRDeviceMediaClassBD

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

Available in OS X v10.5 and later.

Declared in DRDevice.h.

DRDeviceMediaClassCD

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

Available in OS X v10.2 and later.

Declared in DRDevice.h.

DRDeviceMediaClassDVD

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

Available in OS X v10.2 and later.

Declared in DRDevice.h.

DRDeviceMediaClassHDDVD

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

Available in OS X v10.5 and later.

Declared in DRDevice.h.

DRDeviceMediaClassKey

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

Available in OS X v10.2 and later.

Declared in DRDevice.h.

DRDeviceMediaClassUnknown

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

Available in OS X v10.2 and later.

Declared in DRDevice.h.

DRDeviceMediaDoubleLayerL0DataZoneBlocksKey

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.

Available in OS X v10.4 and later.

Declared in DRDevice.h.

DRDeviceMediaFreeSpaceKey

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.

Available in OS X v10.2 and later.

Declared in DRDevice.h.

DRDeviceMediaInfoKey

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.

Available in OS X v10.2 and later.

Declared in DRDevice.h.

DRDeviceMediaIsAppendableKey

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).

Available in OS X v10.2 and later.

Declared in DRDevice.h.

DRDeviceMediaIsBlankKey

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

Available in OS X v10.2 and later.

Declared in DRDevice.h.

DRDeviceMediaIsErasableKey

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

Available in OS X v10.2 and later.

Declared in DRDevice.h.

DRDeviceMediaIsOverwritableKey

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.

Available in OS X v10.3 and later.

Declared in DRDevice.h.

DRDeviceMediaIsReservedKey

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.

Available in OS X v10.2 and later.

Declared in DRDevice.h.

DRDeviceMediaOverwritableSpaceKey

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.

Available in OS X v10.3 and later.

Declared in DRDevice.h.

DRDeviceMediaSessionCountKey

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

Available in OS X v10.2 and later.

Declared in DRDevice.h.

DRDeviceMediaStateInTransition

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

Available in OS X v10.2 and later.

Declared in DRDevice.h.

DRDeviceMediaStateKey

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

Available in OS X v10.2 and later.

Declared in DRDevice.h.

DRDeviceMediaStateMediaPresent

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

Available in OS X v10.2 and later.

Declared in DRDevice.h.

DRDeviceMediaStateNone

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

Available in OS X v10.2 and later.

Declared in DRDevice.h.

DRDeviceMediaTrackCountKey

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

Available in OS X v10.2 and later.

Declared in DRDevice.h.

DRDeviceMediaTypeBDR

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

Available in OS X v10.5 and later.

Declared in DRDevice.h.

DRDeviceMediaTypeBDRE

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

Available in OS X v10.5 and later.

Declared in DRDevice.h.

DRDeviceMediaTypeBDROM

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

Available in OS X v10.5 and later.

Declared in DRDevice.h.

DRDeviceMediaTypeCDR

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

Available in OS X v10.2 and later.

Declared in DRDevice.h.

DRDeviceMediaTypeCDROM

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

Available in OS X v10.2 and later.

Declared in DRDevice.h.

DRDeviceMediaTypeCDRW

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

Available in OS X v10.2 and later.

Declared in DRDevice.h.

DRDeviceMediaTypeDVDPlusR

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

Available in OS X v10.3 and later.

Declared in DRDevice.h.

DRDeviceMediaTypeDVDPlusRDoubleLayer

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

Available in OS X v10.4 and later.

Declared in DRDevice.h.

DRDeviceMediaTypeDVDPlusRW

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

Available in OS X v10.3 and later.

Declared in DRDevice.h.

DRDeviceMediaTypeDVDPlusRWDoubleLayer

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

Available in OS X v10.5 and later.

Declared in DRDevice.h.

DRDeviceMediaTypeDVDR

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

Available in OS X v10.2 and later.

Declared in DRDevice.h.

DRDeviceMediaTypeDVDRAM

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

Available in OS X v10.2 and later.

Declared in DRDevice.h.

DRDeviceMediaTypeDVDRDualLayer

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

Available in OS X v10.5 and later.

Declared in DRDevice.h.

DRDeviceMediaTypeDVDROM

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

Available in OS X v10.2 and later.

Declared in DRDevice.h.

DRDeviceMediaTypeDVDRW

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

Available in OS X v10.2 and later.

Declared in DRDevice.h.

DRDeviceMediaTypeDVDRWDualLayer

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

Available in OS X v10.5 and later.

Declared in DRDevice.h.

DRDeviceMediaTypeHDDVDR

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

Available in OS X v10.5 and later.

Declared in DRDevice.h.

DRDeviceMediaTypeHDDVDRAM

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

Available in OS X v10.5 and later.

Declared in DRDevice.h.

DRDeviceMediaTypeHDDVDRDualLayer

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

Available in OS X v10.5 and later.

Declared in DRDevice.h.

DRDeviceMediaTypeHDDVDROM

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

Available in OS X v10.5 and later.

Declared in DRDevice.h.

DRDeviceMediaTypeHDDVDRW

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

Available in OS X v10.5 and later.

Declared in DRDevice.h.

DRDeviceMediaTypeHDDVDRWDualLayer

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

Available in OS X v10.5 and later.

Declared in DRDevice.h.

DRDeviceMediaTypeKey

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

Available in OS X v10.2 and later.

Declared in DRDevice.h.

DRDeviceMediaTypeUnknown

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

Available in OS X v10.2 and later.

Declared in DRDevice.h.

DRDeviceMediaUsedSpaceKey

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

Available in OS X v10.2 and later.

Declared in DRDevice.h.

DRDevicePhysicalInterconnectATAPI

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

Available in OS X v10.2 and later.

Declared in DRDevice.h.

DRDevicePhysicalInterconnectFibreChannel

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

Available in OS X v10.3 and later.

Declared in DRDevice.h.

DRDevicePhysicalInterconnectFireWire

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

Available in OS X v10.2 and later.

Declared in DRDevice.h.

DRDevicePhysicalInterconnectKey

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

Available in OS X v10.2 and later.

Declared in DRDevice.h.

DRDevicePhysicalInterconnectLocationExternal

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

Available in OS X v10.2 and later.

Declared in DRDevice.h.

DRDevicePhysicalInterconnectLocationInternal

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

Available in OS X v10.2 and later.

Declared in DRDevice.h.

DRDevicePhysicalInterconnectLocationKey

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

Available in OS X v10.2 and later.

Declared in DRDevice.h.

DRDevicePhysicalInterconnectLocationUnknown

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

Available in OS X v10.2 and later.

Declared in DRDevice.h.

DRDevicePhysicalInterconnectSCSI

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

Available in OS X v10.2 and later.

Declared in DRDevice.h.

DRDevicePhysicalInterconnectUSB

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

Available in OS X v10.2 and later.

Declared in DRDevice.h.

DRDeviceProductNameKey

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

Available in OS X v10.2 and later.

Declared in DRDevice.h.

DRDeviceStatusChangedNotification

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.

Available in OS X v10.2 and later.

Declared in DRDevice.h.

DRDeviceSupportLevelAppleShipping

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

Available in OS X v10.2 and later.

Declared in DRDevice.h.

DRDeviceSupportLevelAppleSupported

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

Available in OS X v10.2 and later.

Declared in DRDevice.h.

DRDeviceSupportLevelKey

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

Available in OS X v10.2 and later.

Declared in DRDevice.h.

DRDeviceSupportLevelNone

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

Available in OS X v10.2 and later.

Declared in DRDevice.h.

DRDeviceSupportLevelUnsupported

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

Available in OS X v10.3 and later.

Declared in DRDevice.h.

DRDeviceSupportLevelVendorSupported

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

Available in OS X v10.2 and later.

Declared in DRDevice.h.

DRDeviceTrackInfoKey

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.

Available in OS X v10.3 and later.

Declared in DRDevice.h.

DRDeviceTrackRefsKey

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.

Available in OS X v10.3 and later.

Declared in DRDevice.h.

DRDeviceVendorNameKey

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

Available in OS X v10.2 and later.

Declared in DRDevice.h.

DRDeviceWriteBufferSizeKey

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

Available in OS X v10.3 and later.

Declared in DRDevice.h.

DRDeviceWriteCapabilitiesKey

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.

Available in OS X v10.2 and later.

Declared in DRDevice.h.