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
extern NSString* const DRDeviceAppearedNotification;
Discussion
Posted by a DRNotificationCenter when a device is added to the system.
This notification is registered for only by name.
The object associated with this notification
is the the device that has appeared. The userInfo is the same dictionary
returned by info for that device.
- Availability
- Introduced in Mac OS X v10.2
extern const float DRDeviceBurnSpeedBD1x;
Discussion
4496.0 KB/sec.
- Availability
- Introduced in Mac OS X v10.5.
extern const float DRDeviceBurnSpeedCD1x;
Discussion
176.4 KB/sec.
- Availability
- Introduced in Mac OS X v10.2
extern const float DRDeviceBurnSpeedDVD1x;
Discussion
1385.0 KB/sec.
- Availability
- Introduced in Mac OS X v10.2
extern const float DRDeviceBurnSpeedHDDVD1x;
Discussion
4568.0 KB/sec.
- Availability
- Introduced in Mac OS X v10.5.
extern const float DRDeviceBurnSpeedMax;
Discussion
A value representing the maximum speed at which a device can burn. The
actual speed will vary from device to device.
- Availability
- Introduced in Mac OS X v10.2
extern NSString* const DRDeviceBurnSpeedsKey;
Discussion
One of the keys in the dictionary returned by the status method.
NSArray containing the possible burn speeds available to use.
This key may not be present if no media is inserted.
- Availability
- Introduced in Mac OS X v10.2
extern NSString* const DRDeviceCanTestWriteCDKey;
Discussion
One of the keys in the DRDeviceWriteCapabilitiesKey dictionary.
NSNumber containing a boolean value indicating whether the device can perform a test burn to CD media.
- Availability
- Introduced in Mac OS X v10.2
extern NSString* const DRDeviceCanTestWriteDVDKey;
Discussion
One of the keys in the DRDeviceWriteCapabilitiesKey dictionary.
NSNumber containing a boolean value indicating whether the device can perform a test burn to DVD media.
- Availability
- Introduced in Mac OS X v10.2
extern NSString* const DRDeviceCanUnderrunProtectCDKey;
Discussion
One of the keys in the DRDeviceWriteCapabilitiesKey dictionary.
NSNumber containing a boolean value indicating whether the device supports burn underrun protection when writing to CD media.
- Availability
- Introduced in Mac OS X v10.2
extern NSString* const DRDeviceCanUnderrunProtectDVDKey;
Discussion
One of the keys in the DRDeviceWriteCapabilitiesKey dictionary.
NSNumber containing a boolean value indicating whether the device supports burn underrun protection when writing to DVD media.
- Availability
- Introduced in Mac OS X v10.2
extern NSString* const DRDeviceCanWriteBDKey;
Discussion
One of the keys in the DRDeviceWriteCapabilitiesKey dictionary.
NSNumber containing a boolean value indicating whether the device can write to some type of BD (Blu-ray) based media.
- Availability
- Introduced in Mac OS X v10.5.
extern NSString* const DRDeviceCanWriteBDREKey;
Discussion
One of the keys in the DRDeviceWriteCapabilitiesKey dictionary.
NSNumber containing a boolean value indicating whether the device can write to BD-RE media.
- Availability
- Introduced in Mac OS X v10.5.
extern NSString* const DRDeviceCanWriteBDRKey;
Discussion
One of the keys in the DRDeviceWriteCapabilitiesKey dictionary.
NSNumber containing a boolean value indicating whether the device can write to BD-R media.
- Availability
- Introduced in Mac OS X v10.5.
extern NSString* const DRDeviceCanWriteCDKey;
Discussion
One of the keys in the DRDeviceWriteCapabilitiesKey dictionary.
NSNumber containing a boolean value indicating whether the device can write to some type of CD based media.
- Availability
- Introduced in Mac OS X v10.2
extern NSString* const DRDeviceCanWriteCDRawKey;
Discussion
One of the keys in the DRDeviceWriteCapabilitiesKey dictionary.
NSNumber containing a boolean value indicating whether the device supports a raw mode burn strategy for CD.
Raw mode is sometimes incorrectly referred to as DAO (disc-at-once).
- Availability
- Introduced in Mac OS X v10.3.
extern NSString* const DRDeviceCanWriteCDRKey;
Discussion
One of the keys in the DRDeviceWriteCapabilitiesKey dictionary.
NSNumber containing a boolean value indicating whether the device can write to CD-R media.
- Availability
- Introduced in Mac OS X v10.2
extern NSString* const DRDeviceCanWriteCDRWKey;
Discussion
One of the keys in the DRDeviceWriteCapabilitiesKey dictionary.
NSNumber containing a boolean value indicating whether the device can write to CD-RW media.
- Availability
- Introduced in Mac OS X v10.2
extern NSString* const DRDeviceCanWriteCDSAOKey;
Discussion
One of the keys in the DRDeviceWriteCapabilitiesKey dictionary.
NSNumber containing a boolean value indicating whether the device supports a SAO (session-at-once)
burn strategy for CD.
- Availability
- Introduced in Mac OS X v10.3.
extern NSString* const DRDeviceCanWriteCDTAOKey;
Discussion
One of the keys in the DRDeviceWriteCapabilitiesKey dictionary.
NSNumber containing a boolean value indicating whether the device supports a TAO (track-at-once)
burn strategy for CD.
- Availability
- Introduced in Mac OS X v10.3.
extern NSString* const DRDeviceCanWriteCDTextKey;
Discussion
One of the keys in the DRDeviceWriteCapabilitiesKey dictionary.
NSNumber containing a boolean value indicating whether the device can write CD-Text information to media.
- Availability
- Introduced in Mac OS X v10.2
extern NSString* const DRDeviceCanWriteDVDDAOKey;
Discussion
One of the keys in the DRDeviceWriteCapabilitiesKey dictionary.
NSNumber containing a boolean value indicating whether the device supports a DAO (disc-at-once)
burn strategy on DVD media.
- Availability
- Introduced in Mac OS X v10.3.
extern NSString* const DRDeviceCanWriteDVDKey;
Discussion
One of the keys in the DRDeviceWriteCapabilitiesKey dictionary.
NSNumber containing a boolean value indicating whether the device can write to some type of DVD based media.
- Availability
- Introduced in Mac OS X v10.2
extern NSString* const DRDeviceCanWriteDVDPlusRDoubleLayerKey;
Discussion
One of the keys in the DRDeviceWriteCapabilitiesKey dictionary.
NSNumber containing a boolean value indicating whether the device can write to DVD+R DL media.
- Availability
- Introduced in Mac OS X v10.4.
extern NSString* const DRDeviceCanWriteDVDPlusRKey;
Discussion
One of the keys in the DRDeviceWriteCapabilitiesKey dictionary.
NSNumber containing a boolean value indicating whether the device can write to DVD+R media.
- Availability
- Introduced in Mac OS X v10.3.
extern NSString* const DRDeviceCanWriteDVDPlusRWDoubleLayerKey;
Discussion
One of the keys in the DRDeviceWriteCapabilitiesKey dictionary.
NSNumber containing a boolean value indicating whether the device can write to DVD+RW DL media.
- Availability
- Introduced in Mac OS X v10.5.
extern NSString* const DRDeviceCanWriteDVDPlusRWKey;
Discussion
One of the keys in the DRDeviceWriteCapabilitiesKey dictionary.
NSNumber containing a boolean value indicating whether the device can write to DVD+RW media.
- Availability
- Introduced in Mac OS X v10.3.
extern NSString* const DRDeviceCanWriteDVDRAMKey;
Discussion
One of the keys in the DRDeviceWriteCapabilitiesKey dictionary.
NSNumber containing a boolean value indicating whether the device can write to DVD-RAM media.
- Availability
- Introduced in Mac OS X v10.2
extern NSString* const DRDeviceCanWriteDVDRDualLayerKey;
Discussion
One of the keys in the DRDeviceWriteCapabilitiesKey dictionary.
NSNumber containing a boolean value indicating whether the device can write to DVD-R DL media.
- Availability
- Introduced in Mac OS X v10.5.
extern NSString* const DRDeviceCanWriteDVDRKey;
Discussion
One of the keys in the DRDeviceWriteCapabilitiesKey dictionary.
NSNumber containing a boolean value indicating whether the device can write to DVD-R media.
- Availability
- Introduced in Mac OS X v10.2
extern NSString* const DRDeviceCanWriteDVDRWDualLayerKey;
Discussion
One of the keys in the DRDeviceWriteCapabilitiesKey dictionary.
NSNumber containing a boolean value indicating whether the device can write to DVD-RW DL media.
- Availability
- Introduced in Mac OS X v10.5.
extern NSString* const DRDeviceCanWriteDVDRWKey;
Discussion
One of the keys in the DRDeviceWriteCapabilitiesKey dictionary.
NSNumber containing a boolean value indicating whether the device can write to DVD-RW media.
- Availability
- Introduced in Mac OS X v10.2
extern NSString* const DRDeviceCanWriteHDDVDKey;
Discussion
One of the keys in the DRDeviceWriteCapabilitiesKey dictionary.
NSNumber containing a boolean value indicating whether the device can write to some type of HDDVD based media.
- Availability
- Introduced in Mac OS X v10.5.
extern NSString* const DRDeviceCanWriteHDDVDRAMKey;
Discussion
One of the keys in the DRDeviceWriteCapabilitiesKey dictionary.
NSNumber containing a boolean value indicating whether the device can write to HD DVD-RAM media.
- Availability
- Introduced in Mac OS X v10.5.
extern NSString* const DRDeviceCanWriteHDDVDRDualLayerKey;
Discussion
One of the keys in the DRDeviceWriteCapabilitiesKey dictionary.
NSNumber containing a boolean value indicating whether the device can write to HD DVD-R DL media.
- Availability
- Introduced in Mac OS X v10.5.
extern NSString* const DRDeviceCanWriteHDDVDRKey;
Discussion
One of the keys in the DRDeviceWriteCapabilitiesKey dictionary.
NSNumber containing a boolean value indicating whether the device can write to HD DVD-R media.
- Availability
- Introduced in Mac OS X v10.5.
extern NSString* const DRDeviceCanWriteHDDVDRWDualLayerKey;
Discussion
One of the keys in the DRDeviceWriteCapabilitiesKey dictionary.
NSNumber containing a boolean value indicating whether the device can write to HD DVD-RW DL media.
- Availability
- Introduced in Mac OS X v10.5.
extern NSString* const DRDeviceCanWriteHDDVDRWKey;
Discussion
One of the keys in the DRDeviceWriteCapabilitiesKey dictionary.
NSNumber containing a boolean value indicating whether the device can write to HD DVD-RW media.
- Availability
- Introduced in Mac OS X v10.5.
extern NSString* const DRDeviceCanWriteIndexPointsKey;
Discussion
One of the keys in the DRDeviceWriteCapabilitiesKey dictionary.
NSNumber containing a boolean value indicating whether the device can write index points to CD media.
- Availability
- Introduced in Mac OS X v10.3.
extern NSString* const DRDeviceCanWriteISRCKey;
Discussion
One of the keys in the DRDeviceWriteCapabilitiesKey dictionary.
NSNumber containing a boolean value indicating whether the device can write ISRC to CD media.
- Availability
- Introduced in Mac OS X v10.3.
extern NSString* const DRDeviceCanWriteKey;
Discussion
One of the keys in the DRDeviceWriteCapabilitiesKey dictionary.
NSNumber containing a boolean value indicating whether the device can write to some type of media.
- Availability
- Introduced in Mac OS X v10.2
extern NSString* const DRDeviceCurrentWriteSpeedKey;
Discussion
One of the keys in the dictionary returned by the status method.
NSNumber containing the current burning speed of this device.
- Availability
- Introduced in Mac OS X v10.2
extern NSString* const DRDeviceDisappearedNotification;
Discussion
Posted by a DRNotificationCenter when a device is removed from the system.
The object associated with this notification
is the the device that has disappeared. The userInfo is the same dictionary
returned by info for that device.
- Availability
- Introduced in Mac OS X v10.2
extern NSString* const DRDeviceFirmwareRevisionKey;
Discussion
One of the keys in the dictionary returned by the info method.
NSString containing the firmeware revision extracted from the device.
- Availability
- Introduced in Mac OS X v10.2
extern NSString* const DRDeviceIORegistryEntryPathKey;
Discussion
One of the keys in the dictionary returned by the info method.
NSString containing the path of the device in the IO Registry.
- Availability
- Introduced in Mac OS X v10.2
extern NSString* const DRDeviceIsBusyKey;
Discussion
One of the keys in the dictionary returned by the status method.
NSNumber containing a boolean value indicating whether the device is busy or not.
- Availability
- Introduced in Mac OS X v10.2
extern NSString* const DRDeviceIsTrayOpenKey;
Discussion
One of the keys in the dictionary returned by the status method.
NSNumber containing a boolean value indicating whether the device's tray is open or not.
- Availability
- Introduced in Mac OS X v10.2
extern NSString* const DRDeviceLoadingMechanismCanEjectKey;
Discussion
One of the keys in the dictionary returned by the info method.
NSNumber describing if the loading mechanism of the drive can eject.
- Availability
- Introduced in Mac OS X v10.3.
extern NSString* const DRDeviceLoadingMechanismCanInjectKey;
Discussion
One of the keys in the dictionary returned by the info method.
NSNumber describing if the loading mechanism of the drive can inject.
- Availability
- Introduced in Mac OS X v10.3.
extern NSString* const DRDeviceLoadingMechanismCanOpenKey;
Discussion
One of the keys in the dictionary returned by the info method.
NSNumber describing if the loading mechanism of the drive can open.
- Availability
- Introduced in Mac OS X v10.3.
extern NSString* const DRDeviceMaximumWriteSpeedKey;
Discussion
One of the keys in the dictionary returned by the status method.
NSNumber containing the maximum burning speed of this device.
- Availability
- Introduced in Mac OS X v10.2
extern NSString* const DRDeviceMediaBlocksFreeKey;
Discussion
One of the keys in the DRDeviceMediaInfoKey dictionary.
NSNumber containing the amount of space available (in blocks) on the media to be written to. If the media already contains data
and this value will be less than the normal maximum size of the disc. This value will normally only
be used if the intent is to append data onto an open disc.
- Availability
- Introduced in Mac OS X v10.2
extern NSString* const DRDeviceMediaBlocksOverwritableKey;
Discussion
One of the keys in the DRDeviceMediaInfoKey dictionary.
NSNumber containing the total amount of writable space available (in blocks) on the media to be written to - if that media can be overwritten.
Media that can be overwitten is designated through the DRDeviceMediaIsOverwritableKey .
The overwritable space is the amount of space on the disc that would be available if any data currently
on the disc is first erased.
- Availability
- Introduced in Mac OS X v10.3.
extern NSString* const DRDeviceMediaBlocksUsedKey;
Discussion
One of the keys in the DRDeviceMediaInfoKey dictionary.
NSNumber containing the amount of space currently used (in blocks) for exising data.
- Availability
- Introduced in Mac OS X v10.2
extern NSString* const DRDeviceMediaBSDNameKey;
Discussion
One of the keys in the DRDeviceMediaInfoKey dictionary.
NSString containing the BSD /dev node name assigned to the media in the device.
- Availability
- Introduced in Mac OS X v10.2
extern NSString* const DRDeviceMediaClassBD;
Discussion
One possible value of the DRDeviceMediaClassKey . Indicates the media
is some type of BD (Blu-ray) based media.
- Availability
- Introduced in Mac OS X v10.5.
extern NSString* const DRDeviceMediaClassCD;
Discussion
One possible value of the DRDeviceMediaClassKey . Indicates the media
is some type of CD based media.
- Availability
- Introduced in Mac OS X v10.2
extern NSString* const DRDeviceMediaClassDVD;
Discussion
One possible value of the DRDeviceMediaClassKey . Indicates the media
is some type of DVD based media.
- Availability
- Introduced in Mac OS X v10.2
extern NSString* const DRDeviceMediaClassHDDVD;
Discussion
One possible value of the DRDeviceMediaClassKey . Indicates the media
is some type of HD DVD based media.
- Availability
- Introduced in Mac OS X v10.5.
extern NSString* const DRDeviceMediaClassKey;
Discussion
One of the keys in the DRDeviceMediaInfoKey dictionary.
NSString containing the class of media present in the drive.
- Availability
- Introduced in Mac OS X v10.2
extern NSString* const DRDeviceMediaClassUnknown;
Discussion
One possible value of the DRDeviceMediaClassKey . Indicates the media
class is unknown.
- Availability
- Introduced in Mac OS X v10.2
extern NSString* const DRDeviceMediaDoubleLayerL0DataZoneBlocksKey;
Discussion
One of the keys in the DRDeviceMediaInfoKey dictionary.
NSNumber containing the amount of space available (in blocks) on layer 0 of a double layer
piece of media.
- Availability
- Introduced in Mac OS X v10.4.
extern NSString* const DRDeviceMediaFreeSpaceKey;
Discussion
One of the keys in the DRDeviceMediaInfoKey dictionary.
MSF value of the amount of space available on the media to be written to. If the media already contains data
and this value will be less than the normal maximum size of the disc. This value will normally only
be used if the intent is to append data onto an open disc.
- Availability
- Introduced in Mac OS X v10.2
extern NSString* const DRDeviceMediaInfoKey;
Discussion
One of the keys in the dictionary returned by the status method.
NSDictionary of information describing the media currently in the device.
This key may not be present if no media is inserted.
- Availability
- Introduced in Mac OS X v10.2
extern NSString* const DRDeviceMediaIsAppendableKey;
Discussion
One of the keys in the DRDeviceMediaInfoKey dictionary.
NSNumber containing a boolean value indicating that data can be appended to the exisiting data (if any).
- Availability
- Introduced in Mac OS X v10.2
extern NSString* const DRDeviceMediaIsBlankKey;
Discussion
One of the keys in the DRDeviceMediaInfoKey dictionary.
NSNumber containing a boolean value indicating whether data has previously been written to the media.
- Availability
- Introduced in Mac OS X v10.2
extern NSString* const DRDeviceMediaIsErasableKey;
Discussion
One of the keys in the DRDeviceMediaInfoKey dictionary.
NSNumber containing a boolean value indicating whether this media can be erased.
- Availability
- Introduced in Mac OS X v10.2
extern NSString* const DRDeviceMediaIsOverwritableKey;
Discussion
One of the keys in the DRDeviceMediaInfoKey dictionary.
NSNumber containing a boolean value indicating that the data on the disc (if any) can be overwritten.
Rewritable media can always be erased, and then rewritten in its entirety, so it is always considered overwritable.
Write-once media, if its blank, can also be written in its entirety and is also considered overwritable.
Write-once media, that has been partially written, can never again enter a state where it is entirely writable and will have lost its overwritable designation.
- Availability
- Introduced in Mac OS X v10.3.
extern NSString* const DRDeviceMediaIsReservedKey;
Discussion
One of the keys in the DRDeviceMediaInfoKey dictionary.
NSNumber containing a boolean value indicating whether the media is reserved for exclusive use by
the current process.
- Availability
- Introduced in Mac OS X v10.2
extern NSString* const DRDeviceMediaOverwritableSpaceKey;
Discussion
One of the keys in the DRDeviceMediaInfoKey dictionary.
MSF value of the amount of writable space available on the media to be written to - if that media can be overwritten.
Media that can be overwitten is designated through the DRDeviceMediaIsOverwritableKey .
The overwritable space is the amount of space on the disc that would be available if any data currently
on the disc is first erased.
- Availability
- Introduced in Mac OS X v10.3.
extern NSString* const DRDeviceMediaSessionCountKey;
Discussion
One of the keys in the DRDeviceMediaInfoKey dictionary.
NSNumber containing the current number of sessions present on the media.
- Availability
- Introduced in Mac OS X v10.2
extern NSString* const DRDeviceMediaStateInTransition;
Discussion
One of the possible values for the DRDeviceMediaStateKey .
The media is transitioning from one state to another (i.e., being spun up/down).
- Availability
- Introduced in Mac OS X v10.2
extern NSString* const DRDeviceMediaStateKey;
Discussion
One of the keys in the dictionary returned by the status method.
NSString describing the state of the media.
- Availability
- Introduced in Mac OS X v10.2
extern NSString* const DRDeviceMediaStateMediaPresent;
Discussion
One of the possible values for the DRDeviceMediaStateKey .
Device contains media of some type.
- Availability
- Introduced in Mac OS X v10.2
extern NSString* const DRDeviceMediaStateNone;
Discussion
One of the possible values for the DRDeviceMediaStateKey .
No media is present in the device.
- Availability
- Introduced in Mac OS X v10.2
extern NSString* const DRDeviceMediaTrackCountKey;
Discussion
One of the keys in the DRDeviceMediaInfoKey dictionary.
NSNumber containing the number of tracks present on the media.
- Availability
- Introduced in Mac OS X v10.2
extern NSString* const DRDeviceMediaTypeBDR;
Discussion
One of the possible values of the DRDeviceMediaTypeKey .
Media is a BD-R.
- Availability
- Introduced in Mac OS X v10.5.
extern NSString* const DRDeviceMediaTypeBDRE;
Discussion
One of the possible values of the DRDeviceMediaTypeKey .
Media is a BD-RE.
- Availability
- Introduced in Mac OS X v10.5.
extern NSString* const DRDeviceMediaTypeBDROM;
Discussion
One of the possible values of the DRDeviceMediaTypeKey .
Media is a BD-ROM.
- Availability
- Introduced in Mac OS X v10.5.
extern NSString* const DRDeviceMediaTypeCDR;
Discussion
One of the possible values of the DRDeviceMediaTypeKey .
Media is a CD-R.
- Availability
- Introduced in Mac OS X v10.2
extern NSString* const DRDeviceMediaTypeCDROM;
Discussion
One of the possible values of the DRDeviceMediaTypeKey .
Media is a CD-ROM.
- Availability
- Introduced in Mac OS X v10.2
extern NSString* const DRDeviceMediaTypeCDRW;
Discussion
One of the possible values of the DRDeviceMediaTypeKey .
Media is a CD-RW.
- Availability
- Introduced in Mac OS X v10.2
extern NSString* const DRDeviceMediaTypeDVDPlusR;
Discussion
One of the possible values of the DRDeviceMediaTypeKey .
Media is a DVD+R.
- Availability
- Introduced in Mac OS X v10.3.
extern NSString* const DRDeviceMediaTypeDVDPlusRDoubleLayer;
Discussion
One of the possible values of the DRDeviceMediaTypeKey .
Media is a DVD+R Double Layer.
- Availability
- Introduced in Mac OS X v10.4.
extern NSString* const DRDeviceMediaTypeDVDPlusRW;
Discussion
One of the possible values of the DRDeviceMediaTypeKey .
Media is a DVD+RW.
- Availability
- Introduced in Mac OS X v10.3.
extern NSString* const DRDeviceMediaTypeDVDPlusRWDoubleLayer;
Discussion
One of the possible values of the DRDeviceMediaTypeKey .
Media is a DVD+RW Double Layer.
- Availability
- Introduced in Mac OS X v10.5.
extern NSString* const DRDeviceMediaTypeDVDR;
Discussion
One of the possible values of the DRDeviceMediaTypeKey .
Media is a DVD-R.
- Availability
- Introduced in Mac OS X v10.2
extern NSString* const DRDeviceMediaTypeDVDRAM;
Discussion
One of the possible values of the DRDeviceMediaTypeKey .
Media is a DVD-RAM.
- Availability
- Introduced in Mac OS X v10.2
extern NSString* const DRDeviceMediaTypeDVDRDualLayer;
Discussion
One of the possible values of the DRDeviceMediaTypeKey .
Media is a DVD-R DL.
- Availability
- Introduced in Mac OS X v10.5.
extern NSString* const DRDeviceMediaTypeDVDROM;
Discussion
One of the possible values of the DRDeviceMediaTypeKey .
Media is a DVD-ROM.
- Availability
- Introduced in Mac OS X v10.2
extern NSString* const DRDeviceMediaTypeDVDRW;
Discussion
One of the possible values of the DRDeviceMediaTypeKey .
Media is a DVD-RW.
- Availability
- Introduced in Mac OS X v10.2
extern NSString* const DRDeviceMediaTypeDVDRWDualLayer;
Discussion
One of the possible values of the DRDeviceMediaTypeKey .
Media is a DVD-RW DL.
- Availability
- Introduced in Mac OS X v10.5.
extern NSString* const DRDeviceMediaTypeHDDVDR;
Discussion
One of the possible values of the DRDeviceMediaTypeKey .
Media is a HD DVD-R.
- Availability
- Introduced in Mac OS X v10.5.
extern NSString* const DRDeviceMediaTypeHDDVDRAM;
Discussion
One of the possible values of the DRDeviceMediaTypeKey .
Media is a HD DVD-RAM.
- Availability
- Introduced in Mac OS X v10.5.
extern NSString* const DRDeviceMediaTypeHDDVDRDualLayer;
Discussion
One of the possible values of the DRDeviceMediaTypeKey .
Media is a HD DVD-R DL.
- Availability
- Introduced in Mac OS X v10.5.
extern NSString* const DRDeviceMediaTypeHDDVDROM;
Discussion
One of the possible values of the DRDeviceMediaTypeKey .
Media is a HD DVD-ROM.
- Availability
- Introduced in Mac OS X v10.5.
extern NSString* const DRDeviceMediaTypeHDDVDRW;
Discussion
One of the possible values of the DRDeviceMediaTypeKey .
Media is a HD DVD-RW.
- Availability
- Introduced in Mac OS X v10.5.
extern NSString* const DRDeviceMediaTypeHDDVDRWDualLayer;
Discussion
One of the possible values of the DRDeviceMediaTypeKey .
Media is a HD DVD-RW DL.
- Availability
- Introduced in Mac OS X v10.5.
extern NSString* const DRDeviceMediaTypeKey;
Discussion
One of the keys in the DRDeviceMediaInfoKey dictionary.
NSString containing the type of media inserted in the device.
- Availability
- Introduced in Mac OS X v10.2
extern NSString* const DRDeviceMediaTypeUnknown;
Discussion
One of the possible values of the DRDeviceMediaTypeKey .
The type of the media cannot be determined.
- Availability
- Introduced in Mac OS X v10.2
extern NSString* const DRDeviceMediaUsedSpaceKey;
Discussion
One of the keys in the DRDeviceMediaInfoKey dictionary.
MSF value of the amount of space currently used for exising data.
- Availability
- Introduced in Mac OS X v10.2
extern NSString* const DRDevicePhysicalInterconnectATAPI;
Discussion
One of the possible values of the DRDevicePhysicalInterconnectKey .
Device is connected on an ATAPI interface.
- Availability
- Introduced in Mac OS X v10.2
extern NSString* const DRDevicePhysicalInterconnectFibreChannel;
Discussion
One of the possible values of the DRDevicePhysicalInterconnectKey .
Device is connected through a Fibre Channel interface.
- Availability
- Introduced in Mac OS X v10.3.
extern NSString* const DRDevicePhysicalInterconnectFireWire;
Discussion
One of the possible values of the DRDevicePhysicalInterconnectKey .
Device is connected through a Firewire interface.
- Availability
- Introduced in Mac OS X v10.2
extern NSString* const DRDevicePhysicalInterconnectKey;
Discussion
One of the keys in the dictionary returned by the info method.
NSString describing the connection of the device to the computer.
- Availability
- Introduced in Mac OS X v10.2
extern NSString* const DRDevicePhysicalInterconnectLocationExternal;
Discussion
One of the possible values of the DRDevicePhysicalInterconnectLocationKey .
Device is connected to the machine externally.
- Availability
- Introduced in Mac OS X v10.2
extern NSString* const DRDevicePhysicalInterconnectLocationInternal;
Discussion
One of the possible values of the DRDevicePhysicalInterconnectLocationKey .
Device is connected to the machine internally.
- Availability
- Introduced in Mac OS X v10.2
extern NSString* const DRDevicePhysicalInterconnectLocationKey;
Discussion
One of the keys in the dictionary returned by the info method.
NSString describing the location of the device (e.g. internal/external).
- Availability
- Introduced in Mac OS X v10.2
extern NSString* const DRDevicePhysicalInterconnectLocationUnknown;
Discussion
One of the possible values of the DRDevicePhysicalInterconnectLocationKey .
It's not known how the device is connected.
- Availability
- Introduced in Mac OS X v10.2
extern NSString* const DRDevicePhysicalInterconnectSCSI;
Discussion
One of the possible values of the DRDevicePhysicalInterconnectKey .
Device is connected on a SCSI interface.
- Availability
- Introduced in Mac OS X v10.2
extern NSString* const DRDevicePhysicalInterconnectUSB;
Discussion
One of the possible values of the DRDevicePhysicalInterconnectKey .
Device is connected through a USB interface.
- Availability
- Introduced in Mac OS X v10.2
extern NSString* const DRDeviceProductNameKey;
Discussion
One of the keys in the dictionary returned by the info method.
NSString containing the product name extracted from the device.
- Availability
- Introduced in Mac OS X v10.2
extern NSString* const DRDeviceStatusChangedNotification;
Discussion
Posted by a DRNotificationCenter when the media
in a device changes state. This can include being ejected, inserted, becoming busy,
etc.
The object for this notification is the device who's media is changing state.
The userInfo for this notification is the same dictionary returned by status for
that device.
- Availability
- Introduced in Mac OS X v10.2
extern NSString* const DRDeviceSupportLevelAppleShipping;
Discussion
One of the values for DRDeviceSupportLevelKey . This value indicates
this device is shipping in some Apple machine.
- Availability
- Introduced in Mac OS X v10.2
extern NSString* const DRDeviceSupportLevelAppleSupported;
Discussion
One of the values for DRDeviceSupportLevelKey . This value indicates
this device has been tested by Apple for support.
- Availability
- Introduced in Mac OS X v10.2
extern NSString* const DRDeviceSupportLevelKey;
Discussion
One of the keys in the dictionary returned by the info method.
NSString describing the support level the device enjoys from the engine.
- Availability
- Introduced in Mac OS X v10.2
extern NSString* const DRDeviceSupportLevelNone;
Discussion
One of the values for DRDeviceSupportLevelKey . This value indicates
this device is not supported.
- Availability
- Introduced in Mac OS X v10.2
extern NSString* const DRDeviceSupportLevelUnsupported;
Discussion
One of the values for DRDeviceSupportLevelKey . This value indicates
the device is unsupported, but the engine will try to use it anyway.
- Availability
- Introduced in Mac OS X v10.3.
extern NSString* const DRDeviceSupportLevelVendorSupported;
Discussion
One of the values for DRDeviceSupportLevelKey . This value indicates
this device has been tested by a third party for support.
- Availability
- Introduced in Mac OS X v10.2
extern NSString* const DRDeviceTrackInfoKey;
Discussion
One of the keys in the dictionary returned by the status method.
NSDictionary containing NSDictionaries describing the tracks. DRTracks
from the DRDeviceTrackRefsKey are used as keys into this dictionary.
- Availability
- Introduced in Mac OS X v10.3.
extern NSString* const DRDeviceTrackRefsKey;
Discussion
One of the keys in the dictionary returned by the status method.
NSArray containing a list of DRTrack objects describing any tracks that
are already on the disc.
- Availability
- Introduced in Mac OS X v10.3.
extern NSString* const DRDeviceVendorNameKey;
Discussion
One of the keys in the dictionary returned by the info method.
NSString containing the vendor name extracted from the device.
- Availability
- Introduced in Mac OS X v10.2
extern NSString* const DRDeviceWriteBufferSizeKey;
Discussion
One of the keys in the dictionary returned by the info method.
NSNumber containing the size of the write buffer of the device.
- Availability
- Introduced in Mac OS X v10.3.
extern NSString* const DRDeviceWriteCapabilitiesKey;
Discussion
One of the keys in the dictionary returned by the info method.
NSDictionary containing the capabilities of the device for writing different kinds of media.
- Availability
- Introduced in Mac OS X v10.2
|
Did this document help you? |
Yes: Tell us what works for you.
|
|
Last Updated: 2008-04-01