ADC Home > Reference Library > Reference > Audio > Carbon > Disc Recording Framework Reference

 


DRDevice.h

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


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

DRDeviceBurnSpeedBD1x


extern const float DRDeviceBurnSpeedBD1x;  
Discussion

4496.0 KB/sec.

Availability
Introduced in Mac OS X v10.5.

DRDeviceBurnSpeedCD1x


extern const float DRDeviceBurnSpeedCD1x;  
Discussion

176.4 KB/sec.

Availability
Introduced in Mac OS X v10.2

DRDeviceBurnSpeedDVD1x


extern const float DRDeviceBurnSpeedDVD1x;  
Discussion

1385.0 KB/sec.

Availability
Introduced in Mac OS X v10.2

DRDeviceBurnSpeedHDDVD1x


extern const float DRDeviceBurnSpeedHDDVD1x;  
Discussion

4568.0 KB/sec.

Availability
Introduced in Mac OS X v10.5.

DRDeviceBurnSpeedMax


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

DRDeviceBurnSpeedsKey


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

DRDeviceCanTestWriteCDKey


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

DRDeviceCanTestWriteDVDKey


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

DRDeviceCanUnderrunProtectCDKey


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

DRDeviceCanUnderrunProtectDVDKey


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

DRDeviceCanWriteBDKey


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.

DRDeviceCanWriteBDREKey


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.

DRDeviceCanWriteBDRKey


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.

DRDeviceCanWriteCDKey


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

DRDeviceCanWriteCDRawKey


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.

DRDeviceCanWriteCDRKey


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

DRDeviceCanWriteCDRWKey


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

DRDeviceCanWriteCDSAOKey


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.

DRDeviceCanWriteCDTAOKey


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.

DRDeviceCanWriteCDTextKey


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

DRDeviceCanWriteDVDDAOKey


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.

DRDeviceCanWriteDVDKey


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

DRDeviceCanWriteDVDPlusRDoubleLayerKey


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.

DRDeviceCanWriteDVDPlusRKey


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.

DRDeviceCanWriteDVDPlusRWDoubleLayerKey


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.

DRDeviceCanWriteDVDPlusRWKey


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.

DRDeviceCanWriteDVDRAMKey


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

DRDeviceCanWriteDVDRDualLayerKey


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.

DRDeviceCanWriteDVDRKey


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

DRDeviceCanWriteDVDRWDualLayerKey


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.

DRDeviceCanWriteDVDRWKey


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

DRDeviceCanWriteHDDVDKey


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.

DRDeviceCanWriteHDDVDRAMKey


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.

DRDeviceCanWriteHDDVDRDualLayerKey


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.

DRDeviceCanWriteHDDVDRKey


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.

DRDeviceCanWriteHDDVDRWDualLayerKey


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.

DRDeviceCanWriteHDDVDRWKey


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.

DRDeviceCanWriteIndexPointsKey


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.

DRDeviceCanWriteISRCKey


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.

DRDeviceCanWriteKey


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

DRDeviceCurrentWriteSpeedKey


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

DRDeviceDisappearedNotification


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

DRDeviceFirmwareRevisionKey


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

DRDeviceIORegistryEntryPathKey


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

DRDeviceIsBusyKey


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

DRDeviceIsTrayOpenKey


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

DRDeviceLoadingMechanismCanEjectKey


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.

DRDeviceLoadingMechanismCanInjectKey


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.

DRDeviceLoadingMechanismCanOpenKey


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.

DRDeviceMaximumWriteSpeedKey


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

DRDeviceMediaBlocksFreeKey


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

DRDeviceMediaBlocksOverwritableKey


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.

DRDeviceMediaBlocksUsedKey


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

DRDeviceMediaBSDNameKey


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

DRDeviceMediaClassBD


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.

DRDeviceMediaClassCD


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

DRDeviceMediaClassDVD


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

DRDeviceMediaClassHDDVD


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.

DRDeviceMediaClassKey


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

DRDeviceMediaClassUnknown


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

DRDeviceMediaDoubleLayerL0DataZoneBlocksKey


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.

DRDeviceMediaFreeSpaceKey


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

DRDeviceMediaInfoKey


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

DRDeviceMediaIsAppendableKey


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

DRDeviceMediaIsBlankKey


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

DRDeviceMediaIsErasableKey


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

DRDeviceMediaIsOverwritableKey


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.

DRDeviceMediaIsReservedKey


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

DRDeviceMediaOverwritableSpaceKey


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.

DRDeviceMediaSessionCountKey


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

DRDeviceMediaStateInTransition


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

DRDeviceMediaStateKey


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

DRDeviceMediaStateMediaPresent


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

DRDeviceMediaStateNone


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

DRDeviceMediaTrackCountKey


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

DRDeviceMediaTypeBDR


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.

DRDeviceMediaTypeBDRE


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.

DRDeviceMediaTypeBDROM


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.

DRDeviceMediaTypeCDR


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

DRDeviceMediaTypeCDROM


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

DRDeviceMediaTypeCDRW


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

DRDeviceMediaTypeDVDPlusR


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.

DRDeviceMediaTypeDVDPlusRDoubleLayer


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.

DRDeviceMediaTypeDVDPlusRW


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.

DRDeviceMediaTypeDVDPlusRWDoubleLayer


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.

DRDeviceMediaTypeDVDR


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

DRDeviceMediaTypeDVDRAM


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

DRDeviceMediaTypeDVDRDualLayer


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.

DRDeviceMediaTypeDVDROM


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

DRDeviceMediaTypeDVDRW


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

DRDeviceMediaTypeDVDRWDualLayer


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.

DRDeviceMediaTypeHDDVDR


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.

DRDeviceMediaTypeHDDVDRAM


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.

DRDeviceMediaTypeHDDVDRDualLayer


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.

DRDeviceMediaTypeHDDVDROM


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.

DRDeviceMediaTypeHDDVDRW


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.

DRDeviceMediaTypeHDDVDRWDualLayer


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.

DRDeviceMediaTypeKey


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

DRDeviceMediaTypeUnknown


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

DRDeviceMediaUsedSpaceKey


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

DRDevicePhysicalInterconnectATAPI


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

DRDevicePhysicalInterconnectFibreChannel


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.

DRDevicePhysicalInterconnectFireWire


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

DRDevicePhysicalInterconnectKey


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

DRDevicePhysicalInterconnectLocationExternal


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

DRDevicePhysicalInterconnectLocationInternal


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

DRDevicePhysicalInterconnectLocationKey


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

DRDevicePhysicalInterconnectLocationUnknown


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

DRDevicePhysicalInterconnectSCSI


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

DRDevicePhysicalInterconnectUSB


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

DRDeviceProductNameKey


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

DRDeviceStatusChangedNotification


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

DRDeviceSupportLevelAppleShipping


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

DRDeviceSupportLevelAppleSupported


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

DRDeviceSupportLevelKey


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

DRDeviceSupportLevelNone


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

DRDeviceSupportLevelUnsupported


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.

DRDeviceSupportLevelVendorSupported


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

DRDeviceTrackInfoKey


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.

DRDeviceTrackRefsKey


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.

DRDeviceVendorNameKey


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

DRDeviceWriteBufferSizeKey


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.

DRDeviceWriteCapabilitiesKey


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


Did this document help you?
Yes: Tell us what works for you.
It’s good, but: Report typos, inaccuracies, and so forth.
It wasn’t helpful: Tell us what would have helped.
Last Updated: 2008-04-01