/*
File: DiscRecording/DRDevice.h
Contains: Handles obtaining information about cd/dvd burners connected
to the computer.
Version: Technology: Mac OS X
Release: Mac OS X
Copyright: (c) 2002-2007 Apple Inc. All Rights Reserved.
Bugs?: For bug reports, consult the following page on
the World Wide Web:
http://developer.apple.com/bugreporter/
*/
/*!
@header DRDevice.h
@abstract 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 @link //apple_ref/occ/cl/DRNotificationCenter DRNotificationCenter @/link and listening for the
@link DRDeviceAppearedNotification DRDeviceAppearedNotification @/link. 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
@link DRDeviceAppearedNotification DRDeviceAppearedNotifications @/link. When a client registers for the
@link DRDeviceAppearedNotification DRDeviceAppearedNotification @/link, 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 @link DRDeviceDisappearedNotification DRDeviceDisappearedNotification @/link.
It's also possible to obtain a device instance from its IORegistry path
(@link //apple_ref/occ/clm/DRDevice/deviceForIORegistryEntryPath: deviceForIORegistryEntryPath: @/link)
or the BSD /dev node name (@link //apple_ref/occ/clm/DRDevice/deviceForBSDName: deviceForBSDName: @/link).
If you have a reference to a device instance, you can determine if the physical device
is still valid and connected by sending the @link //apple_ref/occ/instm/DRDevice/isValid isValid @/link 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 @link //apple_ref/occ/instm/DRDevice/acquireMediaReservation acquireMediaReservation @/linkand gives up
its interest by calling @link //apple_ref/occ/instm/DRDevice/releaseMediaReservation releaseMediaReservation @/link. 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 @link DRDeviceMediaIsReservedKey DRDeviceMediaIsReservedKey @/link indicates that your app has obtained
the reservation.
The device tray can be opened (@link //apple_ref/occ/instm/DRDevice/openTray openTray @/link) or
closed (@link //apple_ref/occ/instm/DRDevice/closeTray closeTray @/link) and media
can be ejected (@link //apple_ref/occ/instm/DRDevice/ejectMedia ejectMedia @/link).
*/
#import
#import
#import
#import
/*!
@class DRDevice
@abstract Represents a CD or DVD burner connected to the computer.
@discussion
About Devices
A DRDevice DRDevice represents a physical CD/DVD drive connected to the computer. This class is
mainly for informational purposes since the device is configured by the burn
engine before beginning to optimally handle the burn. The basis for obtaining the
device information is through two methods @link //apple_ref/occ/instm/DRDevice/info info @/link
and @link //apple_ref/occ/instm/DRDevice/status status @/link. @link //apple_ref/occ/instm/DRDevice/info info @/link returns
information pertaining to the drive as a whole and is not affected by the state
of any media in the drive. @link //apple_ref/occ/instm/DRDevice/status status @/link returns information about the media in the drive as
well as those bits of information directly affected by the media (maximum burn speed,
BSD dev node name, etc.)
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 @link //apple_ref/occ/cl/DRNotificationCenter DRNotificationCenter @/link and listening for the
@link DRDeviceAppearedNotification DRDeviceAppearedNotification @/link. 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
@link DRDeviceAppearedNotification DRDeviceAppearedNotifications @/link. When a client registers for the
@link DRDeviceAppearedNotification DRDeviceAppearedNotification @/link, 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 @link DRDeviceDisappearedNotification DRDeviceDisappearedNotification @/link.
It's also possible to obtain a device instance from its IORegistry path
(@link //apple_ref/occ/clm/DRDevice/deviceForIORegistryEntryPath: deviceForIORegistryEntryPath: @/link)
or the BSD /dev node name (@link //apple_ref/occ/clm/DRDevice/deviceForBSDName: deviceForBSDName: @/link).
If you have a reference to a device instance, you can determine if the physical device
is still valid and connected by sending the @link //apple_ref/occ/instm/DRDevice/isValid isValid @/link 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 @link //apple_ref/occ/instm/DRDevice/acquireMediaReservation acquireMediaReservation @/link and gives up
its interest by calling @link //apple_ref/occ/instm/DRDevice/releaseMediaReservation releaseMediaReservation @/link. 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 @link DRDeviceMediaIsReservedKey DRDeviceMediaIsReservedKey @/link indicates that your app has obtained
the reservation.
The device tray can be opened (@link //apple_ref/occ/instm/DRDevice/openTray openTray @/link) or
closed (@link //apple_ref/occ/instm/DRDevice/closeTray closeTray @/link) and media
can be ejected (@link //apple_ref/occ/instm/DRDevice/ejectMedia ejectMedia @/link).
*/
@interface DRDevice : NSObject
{
@private
void* _ref;
}
/*!
@method devices
@abstract Obtains a static list of devices connected to the computer.
@discussion Returns all CD/DVD devices connected to the computer at the time this
method is called. Since devices can come and go at any time, the output of this
method is simply a snapshot of the set of devices connected.
@result An NSArray of DRDevices.
*/
+ (NSArray*) devices;
/*!
@method deviceForBSDName:
@abstract Obtains a DRDevice for the device corresponding to the bsd /dev node.
@discussion If the device is not an authoring device (i.e., CDR, CDRW, DVR-R, etc), returns nil.
@param bsdName The bsd /dev node name.
@result An autoreleased DRDevice object.
*/
+ (DRDevice*) deviceForBSDName:(NSString*)bsdName;
/*!
@method deviceForIORegistryEntryPath:
@abstract Obtains a DRDevice for the device at the path.
@discussion If the device is not an authoring device (i.e., CDR, CDRW, DVR-R, etc), returns nil.
@param path The IORegistry path to the device you wish to obtain a DRDEvice for.
@result An autoreleased DRDevice object.
*/
+ (DRDevice*) deviceForIORegistryEntryPath:(NSString*)path;
/*!
@method isValid
@abstract Returns whether or not the device represented by the receiver is still attached
to the computer.
@discussion Because of the way some physical interconnects work, a device
which is unplugged and replugged in does not necessarily look like the same
device to the computer and would be invalid in that instance.
@result Returns YES if device is valid and NO if not.
*/
- (BOOL) isValid;
/*!
@method info
@abstract Returns a dictionary of information describing the device.
@discussion The information returned include the types of media the device can write to, how
it's connected and its identifying information such as the vendor and product name.
@result An NSDictionary containing device information.
*/
- (NSDictionary*) info;
/*!
@method status
@abstract Returns a dictionary of information describing the media in the device.
@discussion In addition to information about the media (type, space available/used, etc),
the dictionary returned includes those pieces of information about the device
itself which are in part determined by the media (i.e., maximum burn speed).
@result An NSDictionary containing media information.
*/
- (NSDictionary*) status;
/*!
@method openTray
@abstract Commands the device to open its tray.
@discussion Does nothing if the device does not have a tray (slotload). If there is media in
the drive this method will do nothing and return false. In this case use
@link //apple_ref/occ/instm/DRDevice/ejectMedia ejectMedia @/link to eject the media and open the tray.
@result Returns YES if the tray could be opened and NO if not.
*/
- (BOOL) openTray;
/*!
@method closeTray
@abstract Commands the device to close its tray.
@discussion Does nothing if the device does not have a tray (slotload).
@result Returns YES if the tray could be closed and NO if not.
*/
- (BOOL) closeTray;
/*!
@method ejectMedia
@abstract Commands the device to eject the media.
@discussion This command first unmounts any volumes associated with the media and
then ejects the media from the drive. If the media could not be ejected,
most likely this is because a volume associated with the media could not be unmounted.
@result Returns YES if the media could be ejected and NO if not.
*/
- (BOOL) ejectMedia;
/*!
@method acquireExclusiveAccess
@abstract Attempts to acquire an exclusive access session with the device.
@discussion Acquiring exclusive access to the device prevents any process
other than the one acquiring access from communicating with the
device. So once exclusive access is granted, the device is unusable by any other process.
Because of this all volumes mounted from media in the drive must be unmounted
before exclusive access can be granted.
Exclusive access can be acquired multiple times. Each time this method
is called, a call to @link //apple_ref/occ/instm/DRDevice/releaseExclusiveAccess releaseExclusiveAccess @/link> must be made at a later time,
otherwise the process will never release its exclusive access.
@result Returns YES if the exclusinve access is acquired and NO if not.
*/
- (BOOL) acquireExclusiveAccess;
/*!
@method releaseExclusiveAccess
@abstract Releases the latest exclusive access request for the device.
@discussion A call to this method must be made for every call to @link //apple_ref/occ/instm/DRDevice/acquireExclusiveAccess acquireExclusiveAccess @/link,
otherwise the process will never release its exclusive access.
*/
- (void) releaseExclusiveAccess;
/*!
@method acquireMediaReservation
@abstract Indicate an interest in the blank media reservation.
@discussion Blank media participates in a reservation system that allows applications to express
their claim on blank media to other applications. Indicating an interest in the reservation
isn't enough to assume it's been acquired, as there are likely to be other applications in
the system who have also indicated an interest in the blank media reservation. You will
receive a @link DRDeviceStatusChangedNotification DRDeviceStatusChangedNotification @/link with a value of TRUE for the
@link DRDeviceMediaIsReservedKey DRDeviceMediaIsReservedKey @/link when the blank media reservation has been acquired.
This function may be called multiple times. Each time it is called, a call to
@link //apple_ref/occ/instm/DRDevice/releaseMediaReservation releaseMediaReservation @/link must be made at a later time, otherwise the process will
never fully rescind its interest in the blank media reservation.
*/
- (void) acquireMediaReservation;
/*!
@method releaseMediaReservation
@abstract Releases any media reservation that might be in place for the device.
@discussion If media is inserted and reserved, then the reservation will be passed
on to the next process with a reservation request.
*/
- (void) releaseMediaReservation;
/*!
@method isEqualToDevice:
@abstract Compares the receiver to another device.
@param otherDevice Another DRDevice instance to compare to the receiver.
@result Returns YES if the receiver is equal to otherDevice.
*/
- (BOOL) isEqualToDevice:(DRDevice*) otherDevice;
@end
/* -------------------------------------- */
/*" Convenience methods for accessing the various keys contained in the
dictionary returned by info. Each time you want to burn to a disc, an
instance of this class needs to be created. If you want all (or even a few bits)
of this information it's much more efficient to call info yourself and
then extract the needed values from the dictionary. "*/
/*!
@category DRDevice (InfoConvenience)
@discussion This category on DRDevice defines methods that make retrieving
the more commonly accessed DRDevice information dictionary properties easier.
*/
@interface DRDevice (InfoConvenience)
/*!
@method writesCD
@discussion Reports the device's ability to burn to CD-type media.
@result Returns YES if the device has the ability to write to CD-R media.
*/
- (BOOL) writesCD;
/*!
@method writesDVD
@discussion Reports the device's ability to burn to DVD-type media.
@result Returns YES if the device has the ability to write to DVD media.
*/
- (BOOL) writesDVD;
/*!
@method displayName
@discussion Returns an NSString suitable for display in the user interface.
*/
- (NSString*) displayName;
/*!
@method ioRegistryEntryPath
@discussion Returns the path to the device in the IO Registry.
*/
- (NSString*) ioRegistryEntryPath;
@end
/* -------------------------------------- */
/*" Convienience methods for accessing the various keys contained in the
dictionary returned by status. If you want all (or even a few bits)
of this information it's much more efficient to get status yourself
and then extract the needed values from the dictionary. "*/
/*!
@category DRDevice (StatusConvenience)
@discussion This category on DRDevice defines methods that make retrieving
the more commonly accessed DRDevice status dictionary properties easier.
*/
@interface DRDevice (StatusConvenience)
/*!
@method mediaIsPresent
@discussion Reports the presence of the media.
*/
- (BOOL) mediaIsPresent;
/*!
@method mediaIsTransitioning
@discussion Returns YES if the media is in transition (spinning up or down for example).
*/
- (BOOL) mediaIsTransitioning;
/*!
@method mediaIsBusy
@discussion Returns YES if the media is in use by some process - even the one
making this call.
*/
- (BOOL) mediaIsBusy;
/*!
@method mediaType
@discussion Returns the type of media currently inserted into the device.
*/
- (NSString*) mediaType;
/*!
@method mediaIsBlank
@discussion Returns YES the media in the device is blank.
*/
- (BOOL) mediaIsBlank;
/*!
@method mediaIsAppendable
@discussion Returns YES if the media in the device can have more data appended to
any existing data.
*/
- (BOOL) mediaIsAppendable;
/*!
@method mediaIsOverwritable
@discussion Returns YES if the media in the device can be fully (re)written.
*/
- (BOOL) mediaIsOverwritable;
/*!
@method mediaIsErasable
@discussion Returns YES if the media can be erased (i.e., CD-RW, DVD-RW, etc).
*/
- (BOOL) mediaIsErasable;
/*!
@method mediaIsReserved
@discussion Returns YES if the application calling this method currently holds
the reservation on the media.
*/
- (BOOL) mediaIsReserved;
/*!
@method mediaSpaceOverwritable
@discussion Returns the amount of writable space on the media.
*/
- (DRMSF*) mediaSpaceOverwritable;
/*!
@method mediaSpaceUsed
@discussion Returns the amount of used space on the media.
*/
- (DRMSF*) mediaSpaceUsed;
/*!
@method mediaSpaceFree
@discussion Returns the amount of free space on the media.
*/
- (DRMSF*) mediaSpaceFree;
/*!
@method trayIsOpen
@discussion Reports the tray state of the device.
@result Returns YES if the device has a tray and it is open.
*/
- (BOOL) trayIsOpen;
/*!
@method bsdName
@discussion Returns the bsd /dev node name.
*/
- (NSString*) bsdName;
@end
/* -------------------------------------- */
/* Burn speeds */
#if 0
#pragma mark Device Burn Speeds
#endif
/*!
@const DRDeviceBurnSpeedCD1x 176.4 KB/sec.
*/
extern const float DRDeviceBurnSpeedCD1x AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
/*!
@const DRDeviceBurnSpeedDVD1x 1385.0 KB/sec.
*/
extern const float DRDeviceBurnSpeedDVD1x AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
/*!
@const DRDeviceBurnSpeedBD1x 4496.0 KB/sec.
*/
extern const float DRDeviceBurnSpeedBD1x AVAILABLE_MAC_OS_X_VERSION_10_5_AND_LATER;
/*!
@const DRDeviceBurnSpeedHDDVD1x 4568.0 KB/sec.
*/
extern const float DRDeviceBurnSpeedHDDVD1x AVAILABLE_MAC_OS_X_VERSION_10_5_AND_LATER;
/*!
@const DRDeviceBurnSpeedMax
@discussion A value representing the maximum speed at which a device can burn. The
actual speed will vary from device to device.
*/
extern const float DRDeviceBurnSpeedMax AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
/* ---------------------------------------- */
/* Notifications */
#if 0
#pragma mark Device Notifications
#endif
/*!
@const DRDeviceAppearedNotification
@discussion Posted by a @link //apple_ref/occ/cl/DRNotificationCenter DRNotificationCenter @/link 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 @link //apple_ref/occ/instm/DRDevice/info info @/link for that device.
*/
extern NSString* const DRDeviceAppearedNotification AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
/*!
@const DRDeviceDisappearedNotification
@discussion Posted by a @link //apple_ref/occ/cl/DRNotificationCenter DRNotificationCenter @/link 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 @link //apple_ref/occ/instm/DRDevice/info info @/link for that device.
*/
extern NSString* const DRDeviceDisappearedNotification AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
/*!
@const DRDeviceStatusChangedNotification
@discussion Posted by a @link //apple_ref/occ/cl/DRNotificationCenter DRNotificationCenter @/link 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 @link //apple_ref/occ/instm/DRDevice/status status @/link for
that device.
*/
extern NSString* const DRDeviceStatusChangedNotification AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
/* ---------------------------------------- */
/* Keys for the dictionary returned by -[DRDevice info]. */
#if 0
#pragma mark Device Information
#endif
/*!
@const DRDeviceSupportLevelKey
@discussion One of the keys in the dictionary returned by the @link //apple_ref/occ/instm/DRDevice/info info @/link method.
NSString describing the support level the device enjoys from the engine.
*/
extern NSString* const DRDeviceSupportLevelKey AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
/*!
@const DRDeviceIORegistryEntryPathKey
@discussion One of the keys in the dictionary returned by the @link //apple_ref/occ/instm/DRDevice/info info @/link method.
NSString containing the path of the device in the IO Registry.
*/
extern NSString* const DRDeviceIORegistryEntryPathKey AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
/*!
@const DRDeviceWriteCapabilitiesKey
@discussion One of the keys in the dictionary returned by the @link //apple_ref/occ/instm/DRDevice/info info @/link method.
NSDictionary containing the capabilities of the device for writing different kinds of media.
*/
extern NSString* const DRDeviceWriteCapabilitiesKey AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
/*!
@const DRDeviceVendorNameKey
@discussion One of the keys in the dictionary returned by the @link //apple_ref/occ/instm/DRDevice/info info @/link method.
NSString containing the vendor name extracted from the device.
*/
extern NSString* const DRDeviceVendorNameKey AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
/*!
@const DRDeviceProductNameKey
@discussion One of the keys in the dictionary returned by the @link //apple_ref/occ/instm/DRDevice/info info @/link method.
NSString containing the product name extracted from the device.
*/
extern NSString* const DRDeviceProductNameKey AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
/*!
@const DRDeviceFirmwareRevisionKey
@discussion One of the keys in the dictionary returned by the @link //apple_ref/occ/instm/DRDevice/info info @/link method.
NSString containing the firmeware revision extracted from the device.
*/
extern NSString* const DRDeviceFirmwareRevisionKey AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
/*!
@const DRDevicePhysicalInterconnectKey
@discussion One of the keys in the dictionary returned by the @link //apple_ref/occ/instm/DRDevice/info info @/link method.
NSString describing the connection of the device to the computer.
*/
extern NSString* const DRDevicePhysicalInterconnectKey AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
/*!
@const DRDevicePhysicalInterconnectLocationKey
@discussion One of the keys in the dictionary returned by the @link //apple_ref/occ/instm/DRDevice/info info @/link method.
NSString describing the location of the device (e.g. internal/external).
*/
extern NSString* const DRDevicePhysicalInterconnectLocationKey AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
/*!
@const DRDeviceLoadingMechanismCanEjectKey
@discussion One of the keys in the dictionary returned by the @link //apple_ref/occ/instm/DRDevice/info info @/link method.
NSNumber describing if the loading mechanism of the drive can eject.
*/
extern NSString* const DRDeviceLoadingMechanismCanEjectKey AVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER;
/*!
@const DRDeviceLoadingMechanismCanInjectKey
@discussion One of the keys in the dictionary returned by the @link //apple_ref/occ/instm/DRDevice/info info @/link method.
NSNumber describing if the loading mechanism of the drive can inject.
*/
extern NSString* const DRDeviceLoadingMechanismCanInjectKey AVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER;
/*!
@const DRDeviceLoadingMechanismCanOpenKey
@discussion One of the keys in the dictionary returned by the @link //apple_ref/occ/instm/DRDevice/info info @/link method.
NSNumber describing if the loading mechanism of the drive can open.
*/
extern NSString* const DRDeviceLoadingMechanismCanOpenKey AVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER;
/*!
@const DRDeviceWriteBufferSizeKey
@discussion One of the keys in the dictionary returned by the @link //apple_ref/occ/instm/DRDevice/info info @/link method.
NSNumber containing the size of the write buffer of the device.
*/
extern NSString* const DRDeviceWriteBufferSizeKey AVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER;
/* ---------------------------------- */
/* Support levels */
/*!
@const DRDeviceSupportLevelNone
@discussion One of the values for @link DRDeviceSupportLevelKey DRDeviceSupportLevelKey @/link. This value indicates
this device is not supported.
*/
extern NSString* const DRDeviceSupportLevelNone AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
/*!
@const DRDeviceSupportLevelUnsupported
@discussion One of the values for @link DRDeviceSupportLevelKey DRDeviceSupportLevelKey @/link. This value indicates
the device is unsupported, but the engine will try to use it anyway.
*/
extern NSString* const DRDeviceSupportLevelUnsupported AVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER;
/*!
@const DRDeviceSupportLevelVendorSupported
@discussion One of the values for @link DRDeviceSupportLevelKey DRDeviceSupportLevelKey @/link. This value indicates
this device has been tested by a third party for support.
*/
extern NSString* const DRDeviceSupportLevelVendorSupported AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
/*!
@const DRDeviceSupportLevelAppleSupported
@discussion One of the values for @link DRDeviceSupportLevelKey DRDeviceSupportLevelKey @/link. This value indicates
this device has been tested by Apple for support.
*/
extern NSString* const DRDeviceSupportLevelAppleSupported AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
/*!
@const DRDeviceSupportLevelAppleShipping
@discussion One of the values for @link DRDeviceSupportLevelKey DRDeviceSupportLevelKey @/link. This value indicates
this device is shipping in some Apple machine.
*/
extern NSString* const DRDeviceSupportLevelAppleShipping AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
/* ---------------------------------- */
/* Types of physical interconnect */
/*!
@const DRDevicePhysicalInterconnectATAPI
@discussion One of the possible values of the @link DRDevicePhysicalInterconnectKey DRDevicePhysicalInterconnectKey @/link.
Device is connected on an ATAPI interface.
*/
extern NSString* const DRDevicePhysicalInterconnectATAPI AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
/*!
@const DRDevicePhysicalInterconnectFibreChannel
@discussion One of the possible values of the @link DRDevicePhysicalInterconnectKey DRDevicePhysicalInterconnectKey @/link.
Device is connected through a Fibre Channel interface.
*/
extern NSString* const DRDevicePhysicalInterconnectFibreChannel AVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER;
/*!
@const DRDevicePhysicalInterconnectFireWire
@discussion One of the possible values of the @link DRDevicePhysicalInterconnectKey DRDevicePhysicalInterconnectKey @/link.
Device is connected through a Firewire interface.
*/
extern NSString* const DRDevicePhysicalInterconnectFireWire AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
/*!
@const DRDevicePhysicalInterconnectSCSI
@discussion One of the possible values of the @link DRDevicePhysicalInterconnectKey DRDevicePhysicalInterconnectKey @/link.
Device is connected on a SCSI interface.
*/
extern NSString* const DRDevicePhysicalInterconnectSCSI AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
/*!
@const DRDevicePhysicalInterconnectUSB
@discussion One of the possible values of the @link DRDevicePhysicalInterconnectKey DRDevicePhysicalInterconnectKey @/link.
Device is connected through a USB interface.
*/
extern NSString* const DRDevicePhysicalInterconnectUSB AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
/* ---------------------------------- */
/* Physical interconnect locations */
/*!
@const DRDevicePhysicalInterconnectLocationInternal
@discussion One of the possible values of the @link DRDevicePhysicalInterconnectLocationKey DRDevicePhysicalInterconnectLocationKey @/link.
Device is connected to the machine internally.
*/
extern NSString* const DRDevicePhysicalInterconnectLocationInternal AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
/*!
@const DRDevicePhysicalInterconnectLocationExternal
@discussion One of the possible values of the @link DRDevicePhysicalInterconnectLocationKey DRDevicePhysicalInterconnectLocationKey @/link.
Device is connected to the machine externally.
*/
extern NSString* const DRDevicePhysicalInterconnectLocationExternal AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
/*!
@const DRDevicePhysicalInterconnectLocationUnknown
@discussion One of the possible values of the @link DRDevicePhysicalInterconnectLocationKey DRDevicePhysicalInterconnectLocationKey @/link.
It's not known how the device is connected.
*/
extern NSString* const DRDevicePhysicalInterconnectLocationUnknown AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
/* ---------------------------------- */
/* Keys for the write capabilities dictionary, which is a subdictionary under
DRDeviceWriteCapabilitiesKey, in the dictionary returned by -[DRDevice info]. */
/*!
@const DRDeviceCanWriteKey
@discussion One of the keys in the @link DRDeviceWriteCapabilitiesKey DRDeviceWriteCapabilitiesKey @/link dictionary.
NSNumber containing a boolean value indicating whether the device can write to some type of media.
*/
extern NSString* const DRDeviceCanWriteKey AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
/*!
@const DRDeviceCanWriteCDKey
@discussion One of the keys in the @link DRDeviceWriteCapabilitiesKey DRDeviceWriteCapabilitiesKey @/link dictionary.
NSNumber containing a boolean value indicating whether the device can write to some type of CD based media.
*/
extern NSString* const DRDeviceCanWriteCDKey AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
/*!
@const DRDeviceCanWriteCDRKey
@discussion One of the keys in the @link DRDeviceWriteCapabilitiesKey DRDeviceWriteCapabilitiesKey @/link dictionary.
NSNumber containing a boolean value indicating whether the device can write to CD-R media.
*/
extern NSString* const DRDeviceCanWriteCDRKey AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
/*!
@const DRDeviceCanWriteCDRWKey
@discussion One of the keys in the @link DRDeviceWriteCapabilitiesKey DRDeviceWriteCapabilitiesKey @/link dictionary.
NSNumber containing a boolean value indicating whether the device can write to CD-RW media.
*/
extern NSString* const DRDeviceCanWriteCDRWKey AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
/*!
@const DRDeviceCanWriteDVDKey
@discussion One of the keys in the @link DRDeviceWriteCapabilitiesKey DRDeviceWriteCapabilitiesKey @/link dictionary.
NSNumber containing a boolean value indicating whether the device can write to some type of DVD based media.
*/
extern NSString* const DRDeviceCanWriteDVDKey AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
/*!
@const DRDeviceCanWriteDVDRKey
@discussion One of the keys in the @link DRDeviceWriteCapabilitiesKey DRDeviceWriteCapabilitiesKey @/link dictionary.
NSNumber containing a boolean value indicating whether the device can write to DVD-R media.
*/
extern NSString* const DRDeviceCanWriteDVDRKey AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
/*!
@const DRDeviceCanWriteDVDRDualLayerKey
@discussion One of the keys in the @link DRDeviceWriteCapabilitiesKey DRDeviceWriteCapabilitiesKey @/link dictionary.
NSNumber containing a boolean value indicating whether the device can write to DVD-R DL media.
*/
extern NSString* const DRDeviceCanWriteDVDRDualLayerKey AVAILABLE_MAC_OS_X_VERSION_10_5_AND_LATER;
/*!
@const DRDeviceCanWriteDVDRWKey
@discussion One of the keys in the @link DRDeviceWriteCapabilitiesKey DRDeviceWriteCapabilitiesKey @/link dictionary.
NSNumber containing a boolean value indicating whether the device can write to DVD-RW media.
*/
extern NSString* const DRDeviceCanWriteDVDRWKey AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
/*!
@const DRDeviceCanWriteDVDRWDualLayerKey
@discussion One of the keys in the @link DRDeviceWriteCapabilitiesKey DRDeviceWriteCapabilitiesKey @/link dictionary.
NSNumber containing a boolean value indicating whether the device can write to DVD-RW DL media.
*/
extern NSString* const DRDeviceCanWriteDVDRWDualLayerKey AVAILABLE_MAC_OS_X_VERSION_10_5_AND_LATER;
/*!
@const DRDeviceCanWriteDVDRAMKey
@discussion One of the keys in the @link DRDeviceWriteCapabilitiesKey DRDeviceWriteCapabilitiesKey @/link dictionary.
NSNumber containing a boolean value indicating whether the device can write to DVD-RAM media.
*/
extern NSString* const DRDeviceCanWriteDVDRAMKey AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
/*!
@const DRDeviceCanWriteDVDPlusRKey
@discussion One of the keys in the @link DRDeviceWriteCapabilitiesKey DRDeviceWriteCapabilitiesKey @/link dictionary.
NSNumber containing a boolean value indicating whether the device can write to DVD+R media.
*/
extern NSString* const DRDeviceCanWriteDVDPlusRKey AVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER;
/*!
@const DRDeviceCanWriteDVDPlusRDoubleLayerKey
@discussion One of the keys in the @link DRDeviceWriteCapabilitiesKey DRDeviceWriteCapabilitiesKey @/link dictionary.
NSNumber containing a boolean value indicating whether the device can write to DVD+R DL media.
*/
extern NSString* const DRDeviceCanWriteDVDPlusRDoubleLayerKey AVAILABLE_MAC_OS_X_VERSION_10_4_AND_LATER;
/*!
@const DRDeviceCanWriteDVDPlusRWKey
@discussion One of the keys in the @link DRDeviceWriteCapabilitiesKey DRDeviceWriteCapabilitiesKey @/link dictionary.
NSNumber containing a boolean value indicating whether the device can write to DVD+RW media.
*/
extern NSString* const DRDeviceCanWriteDVDPlusRWKey AVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER;
/*!
@const DRDeviceCanWriteDVDPlusRWDoubleLayerKey
@discussion One of the keys in the @link DRDeviceWriteCapabilitiesKey DRDeviceWriteCapabilitiesKey @/link dictionary.
NSNumber containing a boolean value indicating whether the device can write to DVD+RW DL media.
*/
extern NSString* const DRDeviceCanWriteDVDPlusRWDoubleLayerKey AVAILABLE_MAC_OS_X_VERSION_10_5_AND_LATER;
/*!
@const DRDeviceCanWriteBDKey
@discussion One of the keys in the @link DRDeviceWriteCapabilitiesKey DRDeviceWriteCapabilitiesKey @/link dictionary.
NSNumber containing a boolean value indicating whether the device can write to some type of BD (Blu-ray) based media.
*/
extern NSString* const DRDeviceCanWriteBDKey AVAILABLE_MAC_OS_X_VERSION_10_5_AND_LATER;
/*!
@const DRDeviceCanWriteBDRKey
@discussion One of the keys in the @link DRDeviceWriteCapabilitiesKey DRDeviceWriteCapabilitiesKey @/link dictionary.
NSNumber containing a boolean value indicating whether the device can write to BD-R media.
*/
extern NSString* const DRDeviceCanWriteBDRKey AVAILABLE_MAC_OS_X_VERSION_10_5_AND_LATER;
/*!
@const DRDeviceCanWriteBDREKey
@discussion One of the keys in the @link DRDeviceWriteCapabilitiesKey DRDeviceWriteCapabilitiesKey @/link dictionary.
NSNumber containing a boolean value indicating whether the device can write to BD-RE media.
*/
extern NSString* const DRDeviceCanWriteBDREKey AVAILABLE_MAC_OS_X_VERSION_10_5_AND_LATER;
/*!
@const DRDeviceCanWriteHDDVDKey
@discussion One of the keys in the @link DRDeviceWriteCapabilitiesKey DRDeviceWriteCapabilitiesKey @/link dictionary.
NSNumber containing a boolean value indicating whether the device can write to some type of HDDVD based media.
*/
extern NSString* const DRDeviceCanWriteHDDVDKey AVAILABLE_MAC_OS_X_VERSION_10_5_AND_LATER;
/*!
@const DRDeviceCanWriteHDDVDRKey
@discussion One of the keys in the @link DRDeviceWriteCapabilitiesKey DRDeviceWriteCapabilitiesKey @/link dictionary.
NSNumber containing a boolean value indicating whether the device can write to HD DVD-R media.
*/
extern NSString* const DRDeviceCanWriteHDDVDRKey AVAILABLE_MAC_OS_X_VERSION_10_5_AND_LATER;
/*!
@const DRDeviceCanWriteHDDVDRDualLayerKey
@discussion One of the keys in the @link DRDeviceWriteCapabilitiesKey DRDeviceWriteCapabilitiesKey @/link dictionary.
NSNumber containing a boolean value indicating whether the device can write to HD DVD-R DL media.
*/
extern NSString* const DRDeviceCanWriteHDDVDRDualLayerKey AVAILABLE_MAC_OS_X_VERSION_10_5_AND_LATER;
/*!
@const DRDeviceCanWriteHDDVDRAMKey
@discussion One of the keys in the @link DRDeviceWriteCapabilitiesKey DRDeviceWriteCapabilitiesKey @/link dictionary.
NSNumber containing a boolean value indicating whether the device can write to HD DVD-RAM media.
*/
extern NSString* const DRDeviceCanWriteHDDVDRAMKey AVAILABLE_MAC_OS_X_VERSION_10_5_AND_LATER;
/*!
@const DRDeviceCanWriteHDDVDRWKey
@discussion One of the keys in the @link DRDeviceWriteCapabilitiesKey DRDeviceWriteCapabilitiesKey @/link dictionary.
NSNumber containing a boolean value indicating whether the device can write to HD DVD-RW media.
*/
extern NSString* const DRDeviceCanWriteHDDVDRWKey AVAILABLE_MAC_OS_X_VERSION_10_5_AND_LATER;
/*!
@const DRDeviceCanWriteHDDVDRWDualLayerKey
@discussion One of the keys in the @link DRDeviceWriteCapabilitiesKey DRDeviceWriteCapabilitiesKey @/link dictionary.
NSNumber containing a boolean value indicating whether the device can write to HD DVD-RW DL media.
*/
extern NSString* const DRDeviceCanWriteHDDVDRWDualLayerKey AVAILABLE_MAC_OS_X_VERSION_10_5_AND_LATER;
/*!
@const DRDeviceCanWriteCDTextKey
@discussion One of the keys in the @link DRDeviceWriteCapabilitiesKey DRDeviceWriteCapabilitiesKey @/link dictionary.
NSNumber containing a boolean value indicating whether the device can write CD-Text information to media.
*/
extern NSString* const DRDeviceCanWriteCDTextKey AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
/*!
@const DRDeviceCanWriteIndexPointsKey
@discussion One of the keys in the @link DRDeviceWriteCapabilitiesKey DRDeviceWriteCapabilitiesKey @/link dictionary.
NSNumber containing a boolean value indicating whether the device can write index points to CD media.
*/
extern NSString* const DRDeviceCanWriteIndexPointsKey AVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER;
/*!
@const DRDeviceCanWriteISRCKey
@discussion One of the keys in the @link DRDeviceWriteCapabilitiesKey DRDeviceWriteCapabilitiesKey @/link dictionary.
NSNumber containing a boolean value indicating whether the device can write ISRC to CD media.
*/
extern NSString* const DRDeviceCanWriteISRCKey AVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER;
/*!
@const DRDeviceCanWriteCDTAOKey
@discussion One of the keys in the @link DRDeviceWriteCapabilitiesKey DRDeviceWriteCapabilitiesKey @/link dictionary.
NSNumber containing a boolean value indicating whether the device supports a TAO (track-at-once)
burn strategy for CD.
*/
extern NSString* const DRDeviceCanWriteCDTAOKey AVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER;
/*!
@const DRDeviceCanWriteCDSAOKey
@discussion One of the keys in the @link DRDeviceWriteCapabilitiesKey DRDeviceWriteCapabilitiesKey @/link dictionary.
NSNumber containing a boolean value indicating whether the device supports a SAO (session-at-once)
burn strategy for CD.
*/
extern NSString* const DRDeviceCanWriteCDSAOKey AVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER;
/*!
@const DRDeviceCanWriteCDRawKey
@discussion One of the keys in the @link DRDeviceWriteCapabilitiesKey DRDeviceWriteCapabilitiesKey @/link 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).
*/
extern NSString* const DRDeviceCanWriteCDRawKey AVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER;
/*!
@const DRDeviceCanWriteDVDDAOKey
@discussion One of the keys in the @link DRDeviceWriteCapabilitiesKey DRDeviceWriteCapabilitiesKey @/link dictionary.
NSNumber containing a boolean value indicating whether the device supports a DAO (disc-at-once)
burn strategy on DVD media.
*/
extern NSString* const DRDeviceCanWriteDVDDAOKey AVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER;
/*!
@const DRDeviceCanTestWriteCDKey
@discussion One of the keys in the @link DRDeviceWriteCapabilitiesKey DRDeviceWriteCapabilitiesKey @/link dictionary.
NSNumber containing a boolean value indicating whether the device can perform a test burn to CD media.
*/
extern NSString* const DRDeviceCanTestWriteCDKey AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
/*!
@const DRDeviceCanTestWriteDVDKey
@discussion One of the keys in the @link DRDeviceWriteCapabilitiesKey DRDeviceWriteCapabilitiesKey @/link dictionary.
NSNumber containing a boolean value indicating whether the device can perform a test burn to DVD media.
*/
extern NSString* const DRDeviceCanTestWriteDVDKey AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
/*!
@const DRDeviceCanUnderrunProtectCDKey
@discussion One of the keys in the @link DRDeviceWriteCapabilitiesKey DRDeviceWriteCapabilitiesKey @/link dictionary.
NSNumber containing a boolean value indicating whether the device supports burn underrun protection when writing to CD media.
*/
extern NSString* const DRDeviceCanUnderrunProtectCDKey AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
/*!
@const DRDeviceCanUnderrunProtectDVDKey
@discussion One of the keys in the @link DRDeviceWriteCapabilitiesKey DRDeviceWriteCapabilitiesKey @/link dictionary.
NSNumber containing a boolean value indicating whether the device supports burn underrun protection when writing to DVD media.
*/
extern NSString* const DRDeviceCanUnderrunProtectDVDKey AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
/* ---------------------------------- */
/* Keys for the dictionary returned by -[DRDevice status]. */
#if 0
#pragma mark Device Status
#endif
/*!
@const DRDeviceIsBusyKey
@discussion One of the keys in the dictionary returned by the @link //apple_ref/occ/instm/DRDevice/status status @/link method.
NSNumber containing a boolean value indicating whether the device is busy or not.
*/
extern NSString* const DRDeviceIsBusyKey AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
/*!
@const DRDeviceIsTrayOpenKey
@discussion One of the keys in the dictionary returned by the @link //apple_ref/occ/instm/DRDevice/status status @/link method.
NSNumber containing a boolean value indicating whether the device's tray is open or not.
*/
extern NSString* const DRDeviceIsTrayOpenKey AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
/*!
@const DRDeviceMaximumWriteSpeedKey
@discussion One of the keys in the dictionary returned by the @link //apple_ref/occ/instm/DRDevice/status status @/link method.
NSNumber containing the maximum burning speed of this device.
*/
extern NSString* const DRDeviceMaximumWriteSpeedKey AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
/*!
@const DRDeviceCurrentWriteSpeedKey
@discussion One of the keys in the dictionary returned by the @link //apple_ref/occ/instm/DRDevice/status status @/link method.
NSNumber containing the current burning speed of this device.
*/
extern NSString* const DRDeviceCurrentWriteSpeedKey AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
/*!
@const DRDeviceMediaStateKey
@discussion One of the keys in the dictionary returned by the @link //apple_ref/occ/instm/DRDevice/status status @/link method.
NSString describing the state of the media.
*/
extern NSString* const DRDeviceMediaStateKey AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
/*!
@const DRDeviceMediaInfoKey
@discussion One of the keys in the dictionary returned by the @link //apple_ref/occ/instm/DRDevice/status status @/link method.
NSDictionary of information describing the media currently in the device.
This key may not be present if no media is inserted.
*/
extern NSString* const DRDeviceMediaInfoKey AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
/*!
@const DRDeviceBurnSpeedsKey
@discussion One of the keys in the dictionary returned by the @link //apple_ref/occ/instm/DRDevice/status status @/link method.
NSArray containing the possible burn speeds available to use.
This key may not be present if no media is inserted.
*/
extern NSString* const DRDeviceBurnSpeedsKey AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
/*!
@const DRDeviceTrackRefsKey
@discussion One of the keys in the dictionary returned by the @link //apple_ref/occ/instm/DRDevice/status status @/link method.
NSArray containing a list of @link //apple_ref/occ/cl/DRTrack DRTrack @/link objects describing any tracks that
are already on the disc.
*/
extern NSString* const DRDeviceTrackRefsKey AVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER;
/*!
@const DRDeviceTrackInfoKey
@discussion One of the keys in the dictionary returned by the @link //apple_ref/occ/instm/DRDevice/status status @/link method.
NSDictionary containing NSDictionaries describing the tracks. @link //apple_ref/occ/cl/DRTrack DRTracks @/link
from the @link DRDeviceTrackRefsKey DRDeviceTrackRefsKey @/link are used as keys into this dictionary.
*/
extern NSString* const DRDeviceTrackInfoKey AVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER;
/* ---------------------------------- */
/* Media states */
/*!
@const DRDeviceMediaStateMediaPresent
@discussion One of the possible values for the @link DRDeviceMediaStateKey DRDeviceMediaStateKey @/link.
Device contains media of some type.
*/
extern NSString* const DRDeviceMediaStateMediaPresent AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
/*!
@const DRDeviceMediaStateInTransition
@discussion One of the possible values for the @link DRDeviceMediaStateKey DRDeviceMediaStateKey @/link.
The media is transitioning from one state to another (i.e., being spun up/down).
*/
extern NSString* const DRDeviceMediaStateInTransition AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
/*!
@const DRDeviceMediaStateNone
@discussion One of the possible values for the @link DRDeviceMediaStateKey DRDeviceMediaStateKey @/link.
No media is present in the device.
*/
extern NSString* const DRDeviceMediaStateNone AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
/* ---------------------------------- */
/* Keys for the media info dictionary, which is a subdictionary under DRDeviceMediaInfoKey,
in the dictionary returned by -[DRDevice status]. */
/*!
@const DRDeviceMediaBSDNameKey
@discussion One of the keys in the @link DRDeviceMediaInfoKey DRDeviceMediaInfoKey @/link dictionary.
NSString containing the BSD /dev node name assigned to the media in the device.
*/
extern NSString* const DRDeviceMediaBSDNameKey AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
/*!
@const DRDeviceMediaIsBlankKey
@discussion One of the keys in the @link DRDeviceMediaInfoKey DRDeviceMediaInfoKey @/link dictionary.
NSNumber containing a boolean value indicating whether data has previously been written to the media.
*/
extern NSString* const DRDeviceMediaIsBlankKey AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
/*!
@const DRDeviceMediaIsAppendableKey
@discussion One of the keys in the @link DRDeviceMediaInfoKey DRDeviceMediaInfoKey @/link dictionary.
NSNumber containing a boolean value indicating that data can be appended to the exisiting data (if any).
*/
extern NSString* const DRDeviceMediaIsAppendableKey AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
/*!
@const DRDeviceMediaIsOverwritableKey
@discussion One of the keys in the @link DRDeviceMediaInfoKey DRDeviceMediaInfoKey @/link 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.
*/
extern NSString* const DRDeviceMediaIsOverwritableKey AVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER;
/*!
@const DRDeviceMediaIsErasableKey
@discussion One of the keys in the @link DRDeviceMediaInfoKey DRDeviceMediaInfoKey @/link dictionary.
NSNumber containing a boolean value indicating whether this media can be erased.
*/
extern NSString* const DRDeviceMediaIsErasableKey AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
/*!
@const DRDeviceMediaIsReservedKey
@discussion One of the keys in the @link DRDeviceMediaInfoKey DRDeviceMediaInfoKey @/link dictionary.
NSNumber containing a boolean value indicating whether the media is reserved for exclusive use by
the current process.
*/
extern NSString* const DRDeviceMediaIsReservedKey AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
/*!
@const DRDeviceMediaOverwritableSpaceKey
@discussion One of the keys in the @link DRDeviceMediaInfoKey DRDeviceMediaInfoKey @/link 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 @link DRDeviceMediaIsOverwritableKey DRDeviceMediaIsOverwritableKey @/link.
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.
*/
extern NSString* const DRDeviceMediaOverwritableSpaceKey AVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER;
/*!
@const DRDeviceMediaFreeSpaceKey
@discussion One of the keys in the @link DRDeviceMediaInfoKey DRDeviceMediaInfoKey @/link 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.
*/
extern NSString* const DRDeviceMediaFreeSpaceKey AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
/*!
@const DRDeviceMediaUsedSpaceKey
@discussion One of the keys in the @link DRDeviceMediaInfoKey DRDeviceMediaInfoKey @/link dictionary.
MSF value of the amount of space currently used for exising data.
*/
extern NSString* const DRDeviceMediaUsedSpaceKey AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
/*!
@const DRDeviceMediaBlocksOverwritableKey
@discussion One of the keys in the @link DRDeviceMediaInfoKey DRDeviceMediaInfoKey @/link 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 @link DRDeviceMediaIsOverwritableKey DRDeviceMediaIsOverwritableKey @/link.
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.
*/
extern NSString* const DRDeviceMediaBlocksOverwritableKey AVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER;
/*!
@const DRDeviceMediaBlocksFreeKey
@discussion One of the keys in the @link DRDeviceMediaInfoKey DRDeviceMediaInfoKey @/link 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.
*/
extern NSString* const DRDeviceMediaBlocksFreeKey AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
/*!
@const DRDeviceMediaBlocksUsedKey
@discussion One of the keys in the @link DRDeviceMediaInfoKey DRDeviceMediaInfoKey @/link dictionary.
NSNumber containing the amount of space currently used (in blocks) for exising data.
*/
extern NSString* const DRDeviceMediaBlocksUsedKey AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
/*!
@const DRDeviceMediaDoubleLayerL0DataZoneBlocksKey
@discussion One of the keys in the @link DRDeviceMediaInfoKey DRDeviceMediaInfoKey @/link dictionary.
NSNumber containing the amount of space available (in blocks) on layer 0 of a double layer
piece of media.
*/
extern NSString* const DRDeviceMediaDoubleLayerL0DataZoneBlocksKey AVAILABLE_MAC_OS_X_VERSION_10_4_AND_LATER;
/*!
@const DRDeviceMediaTrackCountKey
@discussion One of the keys in the @link DRDeviceMediaInfoKey DRDeviceMediaInfoKey @/link dictionary.
NSNumber containing the number of tracks present on the media.
*/
extern NSString* const DRDeviceMediaTrackCountKey AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
/*!
@const DRDeviceMediaSessionCountKey
@discussion One of the keys in the @link DRDeviceMediaInfoKey DRDeviceMediaInfoKey @/link dictionary.
NSNumber containing the current number of sessions present on the media.
*/
extern NSString* const DRDeviceMediaSessionCountKey AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
/*!
@const DRDeviceMediaClassKey
@discussion One of the keys in the @link DRDeviceMediaInfoKey DRDeviceMediaInfoKey @/link dictionary.
NSString containing the class of media present in the drive.
*/
extern NSString* const DRDeviceMediaClassKey AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
/*!
@const DRDeviceMediaTypeKey
@discussion One of the keys in the @link DRDeviceMediaInfoKey DRDeviceMediaInfoKey @/link dictionary.
NSString containing the type of media inserted in the device.
*/
extern NSString* const DRDeviceMediaTypeKey AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
/* --------------------------------------- */
/* Media classes */
/*!
@const DRDeviceMediaClassCD
@discussion One possible value of the @link DRDeviceMediaClassKey DRDeviceMediaClassKey @/link. Indicates the media
is some type of CD based media.
*/
extern NSString* const DRDeviceMediaClassCD AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
/*!
@const DRDeviceMediaClassDVD
@discussion One possible value of the @link DRDeviceMediaClassKey DRDeviceMediaClassKey @/link. Indicates the media
is some type of DVD based media.
*/
extern NSString* const DRDeviceMediaClassDVD AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
/*!
@const DRDeviceMediaClassBD
@discussion One possible value of the @link DRDeviceMediaClassKey DRDeviceMediaClassKey @/link. Indicates the media
is some type of BD (Blu-ray) based media.
*/
extern NSString* const DRDeviceMediaClassBD AVAILABLE_MAC_OS_X_VERSION_10_5_AND_LATER;
/*!
@const DRDeviceMediaClassHDDVD
@discussion One possible value of the @link DRDeviceMediaClassKey DRDeviceMediaClassKey @/link. Indicates the media
is some type of HD DVD based media.
*/
extern NSString* const DRDeviceMediaClassHDDVD AVAILABLE_MAC_OS_X_VERSION_10_5_AND_LATER;
/*!
@const DRDeviceMediaClassUnknown
@discussion One possible value of the @link DRDeviceMediaClassKey DRDeviceMediaClassKey @/link. Indicates the media
class is unknown.
*/
extern NSString* const DRDeviceMediaClassUnknown AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
/* --------------------------------------- */
/* Media types */
/*!
@const DRDeviceMediaTypeCDROM
@discussion One of the possible values of the @link DRDeviceMediaTypeKey DRDeviceMediaTypeKey @/link.
Media is a CD-ROM.
*/
extern NSString* const DRDeviceMediaTypeCDROM AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
/*!
@const DRDeviceMediaTypeCDR
@discussion One of the possible values of the @link DRDeviceMediaTypeKey DRDeviceMediaTypeKey @/link.
Media is a CD-R.
*/
extern NSString* const DRDeviceMediaTypeCDR AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
/*!
@const DRDeviceMediaTypeCDRW
@discussion One of the possible values of the @link DRDeviceMediaTypeKey DRDeviceMediaTypeKey @/link.
Media is a CD-RW.
*/
extern NSString* const DRDeviceMediaTypeCDRW AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
/*!
@const DRDeviceMediaTypeDVDROM
@discussion One of the possible values of the @link DRDeviceMediaTypeKey DRDeviceMediaTypeKey @/link.
Media is a DVD-ROM.
*/
extern NSString* const DRDeviceMediaTypeDVDROM AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
/*!
@const DRDeviceMediaTypeDVDRAM
@discussion One of the possible values of the @link DRDeviceMediaTypeKey DRDeviceMediaTypeKey @/link.
Media is a DVD-RAM.
*/
extern NSString* const DRDeviceMediaTypeDVDRAM AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
/*!
@const DRDeviceMediaTypeDVDR
@discussion One of the possible values of the @link DRDeviceMediaTypeKey DRDeviceMediaTypeKey @/link.
Media is a DVD-R.
*/
extern NSString* const DRDeviceMediaTypeDVDR AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
/*!
@const DRDeviceMediaTypeDVDRDualLayer
@discussion One of the possible values of the @link DRDeviceMediaTypeKey DRDeviceMediaTypeKey @/link.
Media is a DVD-R DL.
*/
extern NSString* const DRDeviceMediaTypeDVDRDualLayer AVAILABLE_MAC_OS_X_VERSION_10_5_AND_LATER;
/*!
@const DRDeviceMediaTypeDVDRW
@discussion One of the possible values of the @link DRDeviceMediaTypeKey DRDeviceMediaTypeKey @/link.
Media is a DVD-RW.
*/
extern NSString* const DRDeviceMediaTypeDVDRW AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
/*!
@const DRDeviceMediaTypeDVDRWDualLayer
@discussion One of the possible values of the @link DRDeviceMediaTypeKey DRDeviceMediaTypeKey @/link.
Media is a DVD-RW DL.
*/
extern NSString* const DRDeviceMediaTypeDVDRWDualLayer AVAILABLE_MAC_OS_X_VERSION_10_5_AND_LATER;
/*!
@const DRDeviceMediaTypeDVDPlusR
@discussion One of the possible values of the @link DRDeviceMediaTypeKey DRDeviceMediaTypeKey @/link.
Media is a DVD+R.
*/
extern NSString* const DRDeviceMediaTypeDVDPlusR AVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER;
/*!
@const DRDeviceMediaTypeDVDPlusRDoubleLayer
@discussion One of the possible values of the @link DRDeviceMediaTypeKey DRDeviceMediaTypeKey @/link.
Media is a DVD+R Double Layer.
*/
extern NSString* const DRDeviceMediaTypeDVDPlusRDoubleLayer AVAILABLE_MAC_OS_X_VERSION_10_4_AND_LATER;
/*!
@const DRDeviceMediaTypeDVDPlusRW
@discussion One of the possible values of the @link DRDeviceMediaTypeKey DRDeviceMediaTypeKey @/link.
Media is a DVD+RW.
*/
extern NSString* const DRDeviceMediaTypeDVDPlusRW AVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER;
/*!
@const DRDeviceMediaTypeDVDPlusRWDoubleLayer
@discussion One of the possible values of the @link DRDeviceMediaTypeKey DRDeviceMediaTypeKey @/link.
Media is a DVD+RW Double Layer.
*/
extern NSString* const DRDeviceMediaTypeDVDPlusRWDoubleLayer AVAILABLE_MAC_OS_X_VERSION_10_5_AND_LATER;
/*!
@const DRDeviceMediaTypeBDR
@discussion One of the possible values of the @link DRDeviceMediaTypeKey DRDeviceMediaTypeKey @/link.
Media is a BD-R.
*/
extern NSString* const DRDeviceMediaTypeBDR AVAILABLE_MAC_OS_X_VERSION_10_5_AND_LATER;
/*!
@const DRDeviceMediaTypeBDRE
@discussion One of the possible values of the @link DRDeviceMediaTypeKey DRDeviceMediaTypeKey @/link.
Media is a BD-RE.
*/
extern NSString* const DRDeviceMediaTypeBDRE AVAILABLE_MAC_OS_X_VERSION_10_5_AND_LATER;
/*!
@const DRDeviceMediaTypeBDROM
@discussion One of the possible values of the @link DRDeviceMediaTypeKey DRDeviceMediaTypeKey @/link.
Media is a BD-ROM.
*/
extern NSString* const DRDeviceMediaTypeBDROM AVAILABLE_MAC_OS_X_VERSION_10_5_AND_LATER;
/*!
@const DRDeviceMediaTypeHDDVDROM
@discussion One of the possible values of the @link DRDeviceMediaTypeKey DRDeviceMediaTypeKey @/link.
Media is a HD DVD-ROM.
*/
extern NSString* const DRDeviceMediaTypeHDDVDROM AVAILABLE_MAC_OS_X_VERSION_10_5_AND_LATER;
/*!
@const DRDeviceMediaTypeHDDVDR
@discussion One of the possible values of the @link DRDeviceMediaTypeKey DRDeviceMediaTypeKey @/link.
Media is a HD DVD-R.
*/
extern NSString* const DRDeviceMediaTypeHDDVDR AVAILABLE_MAC_OS_X_VERSION_10_5_AND_LATER;
/*!
@const DRDeviceMediaTypeHDDVDRDualLayer
@discussion One of the possible values of the @link DRDeviceMediaTypeKey DRDeviceMediaTypeKey @/link.
Media is a HD DVD-R DL.
*/
extern NSString* const DRDeviceMediaTypeHDDVDRDualLayer AVAILABLE_MAC_OS_X_VERSION_10_5_AND_LATER;
/*!
@const DRDeviceMediaTypeHDDVDRAM
@discussion One of the possible values of the @link DRDeviceMediaTypeKey DRDeviceMediaTypeKey @/link.
Media is a HD DVD-RAM.
*/
extern NSString* const DRDeviceMediaTypeHDDVDRAM AVAILABLE_MAC_OS_X_VERSION_10_5_AND_LATER;
/*!
@const DRDeviceMediaTypeHDDVDRW
@discussion One of the possible values of the @link DRDeviceMediaTypeKey DRDeviceMediaTypeKey @/link.
Media is a HD DVD-RW.
*/
extern NSString* const DRDeviceMediaTypeHDDVDRW AVAILABLE_MAC_OS_X_VERSION_10_5_AND_LATER;
/*!
@const DRDeviceMediaTypeHDDVDRWDualLayer
@discussion One of the possible values of the @link DRDeviceMediaTypeKey DRDeviceMediaTypeKey @/link.
Media is a HD DVD-RW DL.
*/
extern NSString* const DRDeviceMediaTypeHDDVDRWDualLayer AVAILABLE_MAC_OS_X_VERSION_10_5_AND_LATER;
/*!
@const DRDeviceMediaTypeUnknown
@discussion One of the possible values of the @link DRDeviceMediaTypeKey DRDeviceMediaTypeKey @/link.
The type of the media cannot be determined.
*/
extern NSString* const DRDeviceMediaTypeUnknown AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;