Mac Developer Library

Developer

DRDevice.h Reference

Options
Deployment Target:

On This Page

DRDevice.h Reference

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.

  • Declaration

    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.

    • DRDeviceBurnSpeedBD1x

      4496.0 KB/sec.

    • DRDeviceBurnSpeedCD1x

      176.4 KB/sec.

    • DRDeviceBurnSpeedDVD1x

      1385.0 KB/sec.

    • DRDeviceBurnSpeedHDDVD1x

      4568.0 KB/sec.

    • DRDeviceBurnSpeedMax

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

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

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

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

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

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

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

    • DRDeviceCanWriteBDREKey

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

    • DRDeviceCanWriteBDRKey

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

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

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

    • DRDeviceCanWriteCDRKey

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

    • DRDeviceCanWriteCDRWKey

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

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

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

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

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

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

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

    • DRDeviceCanWriteDVDPlusRKey

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

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

    • DRDeviceCanWriteDVDPlusRWKey

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

    • DRDeviceCanWriteDVDRAMKey

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

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

    • DRDeviceCanWriteDVDRKey

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

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

    • DRDeviceCanWriteDVDRWKey

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

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

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

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

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

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

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

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

    • DRDeviceCanWriteISRCKey

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

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

    • DRDeviceCurrentWriteSpeedKey

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

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

    • DRDeviceFirmwareRevisionKey

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

    • DRDeviceIORegistryEntryPathKey

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

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

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

    • DRDeviceLoadingMechanismCanEjectKey

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

    • DRDeviceLoadingMechanismCanInjectKey

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

    • DRDeviceLoadingMechanismCanOpenKey

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

    • DRDeviceMaximumWriteSpeedKey

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

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

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

    • DRDeviceMediaBlocksUsedKey

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

    • DRDeviceMediaBSDNameKey

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

    • DRDeviceMediaClassBD

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

    • DRDeviceMediaClassCD

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

    • DRDeviceMediaClassDVD

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

    • DRDeviceMediaClassHDDVD

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

    • DRDeviceMediaClassKey

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

    • DRDeviceMediaClassUnknown

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

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

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

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

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

    • DRDeviceMediaIsBlankKey

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

    • DRDeviceMediaIsErasableKey

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

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

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

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

    • DRDeviceMediaSessionCountKey

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

    • DRDeviceMediaStateInTransition

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

    • DRDeviceMediaStateKey

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

    • DRDeviceMediaStateMediaPresent

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

    • DRDeviceMediaStateNone

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

    • DRDeviceMediaTrackCountKey

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

    • DRDeviceMediaTypeBDR

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

    • DRDeviceMediaTypeBDRE

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

    • DRDeviceMediaTypeBDROM

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

    • DRDeviceMediaTypeCDR

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

    • DRDeviceMediaTypeCDROM

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

    • DRDeviceMediaTypeCDRW

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

    • DRDeviceMediaTypeDVDPlusR

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

    • DRDeviceMediaTypeDVDPlusRDoubleLayer

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

    • DRDeviceMediaTypeDVDPlusRW

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

    • DRDeviceMediaTypeDVDPlusRWDoubleLayer

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

    • DRDeviceMediaTypeDVDR

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

    • DRDeviceMediaTypeDVDRAM

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

    • DRDeviceMediaTypeDVDRDualLayer

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

    • DRDeviceMediaTypeDVDROM

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

    • DRDeviceMediaTypeDVDRW

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

    • DRDeviceMediaTypeDVDRWDualLayer

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

    • DRDeviceMediaTypeHDDVDR

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

    • DRDeviceMediaTypeHDDVDRAM

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

    • DRDeviceMediaTypeHDDVDRDualLayer

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

    • DRDeviceMediaTypeHDDVDROM

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

    • DRDeviceMediaTypeHDDVDRW

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

    • DRDeviceMediaTypeHDDVDRWDualLayer

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

    • DRDeviceMediaTypeKey

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

    • DRDeviceMediaTypeUnknown

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

    • DRDeviceMediaUsedSpaceKey

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

    • DRDevicePhysicalInterconnectATAPI

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

    • DRDevicePhysicalInterconnectFibreChannel

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

    • DRDevicePhysicalInterconnectFireWire

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

    • DRDevicePhysicalInterconnectKey

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

    • DRDevicePhysicalInterconnectLocationExternal

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

    • DRDevicePhysicalInterconnectLocationInternal

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

    • DRDevicePhysicalInterconnectLocationKey

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

    • DRDevicePhysicalInterconnectLocationUnknown

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

    • DRDevicePhysicalInterconnectSCSI

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

    • DRDevicePhysicalInterconnectUSB

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

    • DRDeviceProductNameKey

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

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

    • DRDeviceSupportLevelAppleShipping

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

    • DRDeviceSupportLevelAppleSupported

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

    • DRDeviceSupportLevelKey

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

    • DRDeviceSupportLevelNone

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

    • DRDeviceSupportLevelUnsupported

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

    • DRDeviceSupportLevelVendorSupported

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

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

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

    • DRDeviceVendorNameKey

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

    • DRDeviceWriteBufferSizeKey

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

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