DRCoreDevice.h Reference

Declared in
DRCoreDevice.h

Overview

Device interfaces for Disc Recording.

Included Headers

  • <CoreServices/CoreServices.h>

  • <DiscRecording/DRCoreObject.h>

  • <AvailabilityMacros.h>

  • <math.h>

  • <IOKit/IOKitLib.h>

Functions

See the Overview for header-level documentation.

DRCopyDeviceArray

Returns an array of all writable devices connected to the system.

extern CFArrayRef DRCopyDeviceArray(
   void) AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
Return Value

A CFArray containing the devices attached to the system at the time the function is called.

Discussion

FireWire, USB, and other technologies allow users to connect and disconnect devices while a computer is on. The device array returned by this function is a snapshot that is not guaranteed to stay current for the lifetime of a process.

Since device connections are dynamic, a better option than this function is to maintain a list of attached devices by listening for kDRDeviceAppearedNotification and kDRDeviceDisappearedNotification notifications. This function is most useful for initially populating a list of devices.

Availability
  • Available in OS X v10.2 and later.
Declared In
DRCoreDevice.h

DRDeviceAcquireExclusiveAccess

Attempts to acquire an exclusive access session with the device.

extern OSStatus DRDeviceAcquireExclusiveAccess(
   DRDeviceRef device) AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
Parameters
device

The device reference for which to acquire exclusive access.

Return Value

An error code indicating whether exclusive access could be acquired.

Discussion

If this function succeeds, the device becomes unusable by any other process. All volumes mounted from media in the drive must be unmounted before exclusive access can be granted. The Disc Recording engine attempts to unmount volumes for you, but this call will fail if some volumes could not be unmounted.

Your application may call this function multiple times. Each time, a call to DRDeviceReleaseExclusiveAccess must be made at a later time or the process will never release its exclusive access.

Availability
  • Available in OS X v10.2 and later.
Declared In
DRCoreDevice.h

DRDeviceAcquireMediaReservation

Indicates an interest in reserving blank media.

extern void DRDeviceAcquireMediaReservation(
   DRDeviceRef device) AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
Parameters
device

The device reference for which to indicate an interest.

Discussion

Blank media participates in a reservation system thats allows applications to express claims on blank media to other applications. Indicating an interest to reserve blank media does not guarantee acquisition--there may be other applications that have indicated an interest in the same media.

Your application will receive a kDRDeviceStatusChangedNotification notification with a value of true for the kDRDeviceMediaIsReservedKey when a blank media reservation has been acquired.

This function may be called multiple times. Each time it is called, a call to DRDeviceReleaseMediaReservation must be made at a later time or the process will never fully rescind its interest in the blank media reservation.

Availability
  • Available in OS X v10.2 and later.
Declared In
DRCoreDevice.h

DRDeviceCDXFactorForKPS

#define DRDeviceCDXFactorForKPS(kps) (UInt32)floor((kps)/kDRDeviceBurnSpeedCD1x + 0.5)
Discussion

A macro for converting from a KB/s value to the equivalent x-factor (1x, 8x, 20x, etc.) for a CD burn, where 1 KB = 1000 bytes.

Availability
  • Available in OS X v10.2 and later.
Declared In
DRCoreDevice.h

DRDeviceCloseTray

Commands a device to close its tray.

extern OSStatus DRDeviceCloseTray(
   DRDeviceRef device) AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
Parameters
device

Device to close.

Return Value

An error code indicating if the tray could be closed.

Discussion

This function will close the tray of the device, if it has one.

Availability
  • Available in OS X v10.2 and later.
Declared In
DRCoreDevice.h

DRDeviceCopyDeviceForBSDName

Returns the device reference corresponding to the BSD device name.

extern DRDeviceRef DRDeviceCopyDeviceForBSDName(
   CFStringRef name) AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
Parameters
name

The /dev entry for the device (i.e., disk1)

Return Value

A DRDevice reference for the device corresponding to the BSD name.

Availability
  • Available in OS X v10.2 and later.
Declared In
DRCoreDevice.h

DRDeviceCopyDeviceForIORegistryEntryPath

Returns the device reference corresponding to the IORegistry entry.

extern DRDeviceRef DRDeviceCopyDeviceForIORegistryEntryPath(
   CFStringRef path) AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
Parameters
path

The IORegistry entry path corresponding to the device.

Return Value

A DRDevice reference for the device corresponding to the IORegistry entry path.

Availability
  • Available in OS X v10.2 and later.
Declared In
DRCoreDevice.h

DRDeviceCopyInfo

Returns information about the device.

extern CFDictionaryRef DRDeviceCopyInfo(
   DRDeviceRef device) AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
Parameters
device

The device to query.

Return Value

A CFDictionary object identifying the device and its capabilities.

Discussion

This function returns information that identifies the device and describes its capabilites. The information includes the vendor's name, the product identifier, whether the device can burn CDs or DVDs, and so on.

Availability
  • Available in OS X v10.2 and later.
Declared In
DRCoreDevice.h

DRDeviceCopyStatus

Returns the status of the device.

extern CFDictionaryRef DRDeviceCopyStatus(
   DRDeviceRef device) AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
Parameters
device

The device to query.

Return Value

A CFDictionary object describing the status of the device and any media it contains.

Discussion

This function returns information about the status of the device. This information includes whether media is present or not, and, if present, a descripton of the media including its size, kind, and so on.

Availability
  • Available in OS X v10.2 and later.
Declared In
DRCoreDevice.h

DRDeviceDVDXFactorForKPS

#define DRDeviceDVDXFactorForKPS(kps) (UInt32)floor((kps)/kDRDeviceBurnSpeedDVD1x + 0.5)
Discussion

A macro for converting from a KB/s value to the equivalent x-factor (1x, 8x, 20x, etc.) for a DVD burn, where 1 KB = 1000 bytes.

Availability
  • Available in OS X v10.2 and later.
Declared In
DRCoreDevice.h

DRDeviceEjectMedia

Commands a device to unmount and eject media.

extern OSStatus DRDeviceEjectMedia(
   DRDeviceRef device) AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
Parameters
device

Device to eject.

Return Value

An error code indicating whether the media could be ejected.

Discussion

If media is present but cannot be unmounted, this function will fail and return an error. If there is no media in the device, this function is equivalent to DRDeviceOpenTray .

Availability
  • Available in OS X v10.2 and later.
Declared In
DRCoreDevice.h

DRDeviceGetTypeID

Returns the type identifier of all DRDevice instances.

extern CFTypeID DRDeviceGetTypeID(
   void) AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
Availability
  • Available in OS X v10.2 and later.
Declared In
DRCoreDevice.h

DRDeviceIsValid

Determines whether the device is still attached and turned on.

extern Boolean DRDeviceIsValid(
   DRDeviceRef device) AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
Parameters
device

The device reference to check.

Return Value

A boolean indicating whether the device reference is still usable (TRUE) or not (FALSE).

Discussion

Devices can be removed from a system while a client has a reference to them. This function allows clients to check if a device reference they are holding is still usable.

Availability
  • Available in OS X v10.2 and later.
Declared In
DRCoreDevice.h

DRDeviceKPSForCDXFactor

#define DRDeviceKPSForCDXFactor(xfactor) ((float)(xfactor) * kDRDeviceBurnSpeedCD1x)
Discussion

Macro for converting from an x-factor (1x, 8x, 20x, etc) to the real KB/s value for a CD burn. For this macro, 1 KB = 1000 bytes.

Availability
  • Available in OS X v10.2 and later.
Declared In
DRCoreDevice.h

DRDeviceKPSForDVDXFactor

#define DRDeviceKPSForDVDXFactor(xfactor) ((float)(xfactor) * kDRDeviceBurnSpeedDVD1x)
Discussion

A macro for converting from an x-factor (1x, 8x, 20x, etc.) to the real KB/s value for a DVD burn, where 1 KB = 1000 bytes.

Availability
  • Available in OS X v10.2 and later.
Declared In
DRCoreDevice.h

DRDeviceKPSForXFactor

Converts from media type specific X-factors to K/s values.

extern float DRDeviceKPSForXFactor(
   DRTypeRef deviceOrMediaType,
   float xfactor) AVAILABLE_MAC_OS_X_VERSION_10_5_AND_LATER;
Parameters
deviceOrMediaType

Either a DRDeviceRef for a device containing media, or a CFStringRef corresponding to a media type. xfactor A media type specific X-factor, corresponding to the media type identified by the deviceOrMediaType param, that will be converted into K/s.

Return Value

The media type specific X-factor converted to K/s, or 0 if the X-factor could not be converted to a K/s value.

Discussion

Since X-factors are media type specific and DiscRecording uses K/s values to specify burn speeds, this function can be used to easily and accurately convert from raw K/s values to X-factors when appropriate.

Availability
  • Available in OS X v10.5 and later.
Declared In
DRCoreDevice.h

DRDeviceOpenTray

Commands a device to open up its tray.

extern OSStatus DRDeviceOpenTray(
   DRDeviceRef device) AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
Parameters
device

Device to open.

Return Value

An error code indicating if the tray could be opened.

Discussion

This function will open the tray of the device, if it has one, if and only if the device does not currently have mounted media.

Availability
  • Available in OS X v10.2 and later.
Declared In
DRCoreDevice.h

DRDeviceReleaseExclusiveAccess

Release exclusive access to a device.

extern void DRDeviceReleaseExclusiveAccess(
   DRDeviceRef device) AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
Parameters
device

The device reference for which to release exclusive access.

Discussion

This function will release one request for exclusive access made by a process that called DRDeviceAcquireExclusiveAccess. A call to this function must be made for every call to DRDeviceAcquireExclusiveAccess , otherwise the process will never release its exclusive access.

Availability
  • Available in OS X v10.2 and later.
Declared In
DRCoreDevice.h

DRDeviceReleaseMediaReservation

Rescind an interest in the blank media reservation.

extern void DRDeviceReleaseMediaReservation(
   DRDeviceRef device) AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
Parameters
device

The device reference for which to rescind an interest.

Discussion

If the process currently has a reservation, it will be released and passed on to the next interested process.

Availability
  • Available in OS X v10.2 and later.
Declared In
DRCoreDevice.h

DRDeviceXFactorForKPS

Converts from K/s values to media type specific X-factors.

extern float DRDeviceXFactorForKPS(
   DRTypeRef deviceOrMediaType,
   float kps) AVAILABLE_MAC_OS_X_VERSION_10_5_AND_LATER;
Parameters
deviceOrMediaType

Either a DRDeviceRef for a device containing media, or a CFStringRef corresponding to a media type. kps The K/s value to be converted into an X-factor, corresponding to the media type identified by the deviceOrMediaType param.

Return Value

The K/s value converted to media type specific X-factor, or 0 if the K/s value could not be converted to a media type specfic X-factor.

Discussion

Since DiscRecording uses K/s values to specify burn speeds and X-factors are media type specific, this function can be used to easily and accurately convert from X-factors to raw K/s values when appropriate.

Availability
  • Available in OS X v10.5 and later.
Declared In
DRCoreDevice.h

Data Types

See the Overview for header-level documentation.

DRDeviceRef

typedef struct __DRDevice* DRDeviceRef;
Discussion

This is the type of a reference to DRDevices.

Availability
  • Available in OS X v10.2 and later.
Declared In
DRCoreDevice.h

Constants

See the Overview for header-level documentation.

Global Constants

extern const CFStringRef kDRDeviceAppearedNotificationAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
extern const float kDRDeviceBurnSpeedBD1xAVAILABLE_MAC_OS_X_VERSION_10_5_AND_LATER;
extern const float kDRDeviceBurnSpeedCD1xAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
extern const float kDRDeviceBurnSpeedDVD1xAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
extern const float kDRDeviceBurnSpeedHDDVD1xAVAILABLE_MAC_OS_X_VERSION_10_5_AND_LATER;
extern const float kDRDeviceBurnSpeedMaxAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
extern const CFStringRef kDRDeviceBurnSpeedsKeyAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
extern const CFStringRef kDRDeviceCanTestWriteCDKeyAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
extern const CFStringRef kDRDeviceCanTestWriteDVDKeyAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
extern const CFStringRef kDRDeviceCanUnderrunProtectCDKeyAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
extern const CFStringRef kDRDeviceCanUnderrunProtectDVDKeyAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
extern const CFStringRef kDRDeviceCanWriteBDKeyAVAILABLE_MAC_OS_X_VERSION_10_5_AND_LATER;
extern const CFStringRef kDRDeviceCanWriteBDREKeyAVAILABLE_MAC_OS_X_VERSION_10_5_AND_LATER;
extern const CFStringRef kDRDeviceCanWriteBDRKeyAVAILABLE_MAC_OS_X_VERSION_10_5_AND_LATER;
extern const CFStringRef kDRDeviceCanWriteCDKeyAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
extern const CFStringRef kDRDeviceCanWriteCDRawKeyAVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER;
extern const CFStringRef kDRDeviceCanWriteCDRKeyAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
extern const CFStringRef kDRDeviceCanWriteCDRWKeyAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
extern const CFStringRef kDRDeviceCanWriteCDSAOKeyAVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER;
extern const CFStringRef kDRDeviceCanWriteCDTAOKeyAVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER;
extern const CFStringRef kDRDeviceCanWriteCDTextKeyAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
extern const CFStringRef kDRDeviceCanWriteDVDDAOKeyAVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER;
extern const CFStringRef kDRDeviceCanWriteDVDKeyAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
extern const CFStringRef kDRDeviceCanWriteDVDPlusRDoubleLayerKeyAVAILABLE_MAC_OS_X_VERSION_10_4_AND_LATER;
extern const CFStringRef kDRDeviceCanWriteDVDPlusRKeyAVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER;
extern const CFStringRef kDRDeviceCanWriteDVDPlusRWDoubleLayerKeyAVAILABLE_MAC_OS_X_VERSION_10_5_AND_LATER;
extern const CFStringRef kDRDeviceCanWriteDVDPlusRWKeyAVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER;
extern const CFStringRef kDRDeviceCanWriteDVDRAMKeyAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
extern const CFStringRef kDRDeviceCanWriteDVDRDualLayerKeyAVAILABLE_MAC_OS_X_VERSION_10_5_AND_LATER;
extern const CFStringRef kDRDeviceCanWriteDVDRKeyAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
extern const CFStringRef kDRDeviceCanWriteDVDRWDualLayerKeyAVAILABLE_MAC_OS_X_VERSION_10_5_AND_LATER;
extern const CFStringRef kDRDeviceCanWriteDVDRWKeyAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
extern const CFStringRef kDRDeviceCanWriteHDDVDKeyAVAILABLE_MAC_OS_X_VERSION_10_5_AND_LATER;
extern const CFStringRef kDRDeviceCanWriteHDDVDRAMKeyAVAILABLE_MAC_OS_X_VERSION_10_5_AND_LATER;
extern const CFStringRef kDRDeviceCanWriteHDDVDRDualLayerKeyAVAILABLE_MAC_OS_X_VERSION_10_5_AND_LATER;
extern const CFStringRef kDRDeviceCanWriteHDDVDRKeyAVAILABLE_MAC_OS_X_VERSION_10_5_AND_LATER;
extern const CFStringRef kDRDeviceCanWriteHDDVDRWDualLayerKeyAVAILABLE_MAC_OS_X_VERSION_10_5_AND_LATER;
extern const CFStringRef kDRDeviceCanWriteHDDVDRWKeyAVAILABLE_MAC_OS_X_VERSION_10_5_AND_LATER;
extern const CFStringRef kDRDeviceCanWriteIndexPointsKeyAVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER;
extern const CFStringRef kDRDeviceCanWriteISRCKeyAVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER;
extern const CFStringRef kDRDeviceCanWriteKeyAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
extern const CFStringRef kDRDeviceCurrentWriteSpeedKeyAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
extern const CFStringRef kDRDeviceDisappearedNotificationAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
extern const CFStringRef kDRDeviceFirmwareRevisionKeyAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
extern const CFStringRef kDRDeviceIORegistryEntryPathKeyAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
extern const CFStringRef kDRDeviceIsBusyKeyAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
extern const CFStringRef kDRDeviceIsTrayOpenKeyAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
extern const CFStringRef kDRDeviceLoadingMechanismCanEjectKeyAVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER;
extern const CFStringRef kDRDeviceLoadingMechanismCanInjectKeyAVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER;
extern const CFStringRef kDRDeviceLoadingMechanismCanOpenKeyAVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER;
extern const CFStringRef kDRDeviceMaximumWriteSpeedKeyAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
extern const CFStringRef kDRDeviceMediaBlocksFreeKeyAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
extern const CFStringRef kDRDeviceMediaBlocksOverwritableKeyAVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER;
extern const CFStringRef kDRDeviceMediaBlocksUsedKeyAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
extern const CFStringRef kDRDeviceMediaBSDNameKeyAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
extern const CFStringRef kDRDeviceMediaClassBDAVAILABLE_MAC_OS_X_VERSION_10_5_AND_LATER;
extern const CFStringRef kDRDeviceMediaClassCDAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
extern const CFStringRef kDRDeviceMediaClassDVDAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
extern const CFStringRef kDRDeviceMediaClassHDDVDAVAILABLE_MAC_OS_X_VERSION_10_5_AND_LATER;
extern const CFStringRef kDRDeviceMediaClassKeyAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
extern const CFStringRef kDRDeviceMediaClassUnknownAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
extern const CFStringRef kDRDeviceMediaDoubleLayerL0DataZoneBlocksKeyAVAILABLE_MAC_OS_X_VERSION_10_4_AND_LATER;
extern const CFStringRef kDRDeviceMediaInfoKeyAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
extern const CFStringRef kDRDeviceMediaIsAppendableKeyAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
extern const CFStringRef kDRDeviceMediaIsBlankKeyAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
extern const CFStringRef kDRDeviceMediaIsErasableKeyAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
extern const CFStringRef kDRDeviceMediaIsOverwritableKeyAVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER;
extern const CFStringRef kDRDeviceMediaIsReservedKeyAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
extern const CFStringRef kDRDeviceMediaSessionCountKeyAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
extern const CFStringRef kDRDeviceMediaStateInTransitionAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
extern const CFStringRef kDRDeviceMediaStateKeyAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
extern const CFStringRef kDRDeviceMediaStateMediaPresentAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
extern const CFStringRef kDRDeviceMediaStateNoneAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
extern const CFStringRef kDRDeviceMediaTrackCountKeyAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
extern const CFStringRef kDRDeviceMediaTypeBDRAVAILABLE_MAC_OS_X_VERSION_10_5_AND_LATER;
extern const CFStringRef kDRDeviceMediaTypeBDREAVAILABLE_MAC_OS_X_VERSION_10_5_AND_LATER;
extern const CFStringRef kDRDeviceMediaTypeBDREAVAILABLE_MAC_OS_X_VERSION_10_5_AND_LATER;
extern const CFStringRef kDRDeviceMediaTypeBDROMAVAILABLE_MAC_OS_X_VERSION_10_5_AND_LATER;
extern const CFStringRef kDRDeviceMediaTypeCDRAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
extern const CFStringRef kDRDeviceMediaTypeCDROMAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
extern const CFStringRef kDRDeviceMediaTypeCDRWAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
extern const CFStringRef kDRDeviceMediaTypeDVDPlusRAVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER;
extern const CFStringRef kDRDeviceMediaTypeDVDPlusRDoubleLayerAVAILABLE_MAC_OS_X_VERSION_10_4_AND_LATER;
extern const CFStringRef kDRDeviceMediaTypeDVDPlusRWAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
extern const CFStringRef kDRDeviceMediaTypeDVDPlusRWDoubleLayerAVAILABLE_MAC_OS_X_VERSION_10_5_AND_LATER;
extern const CFStringRef kDRDeviceMediaTypeDVDRAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
extern const CFStringRef kDRDeviceMediaTypeDVDRAMAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
extern const CFStringRef kDRDeviceMediaTypeDVDRDualLayerAVAILABLE_MAC_OS_X_VERSION_10_5_AND_LATER;
extern const CFStringRef kDRDeviceMediaTypeDVDROMAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
extern const CFStringRef kDRDeviceMediaTypeDVDRWAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
extern const CFStringRef kDRDeviceMediaTypeDVDRWDualLayerAVAILABLE_MAC_OS_X_VERSION_10_5_AND_LATER;
extern const CFStringRef kDRDeviceMediaTypeHDDVDRAVAILABLE_MAC_OS_X_VERSION_10_5_AND_LATER;
extern const CFStringRef kDRDeviceMediaTypeHDDVDRAMAVAILABLE_MAC_OS_X_VERSION_10_5_AND_LATER;
extern const CFStringRef kDRDeviceMediaTypeHDDVDRDualLayerAVAILABLE_MAC_OS_X_VERSION_10_5_AND_LATER;
extern const CFStringRef kDRDeviceMediaTypeHDDVDROMAVAILABLE_MAC_OS_X_VERSION_10_5_AND_LATER;
extern const CFStringRef kDRDeviceMediaTypeHDDVDRWAVAILABLE_MAC_OS_X_VERSION_10_5_AND_LATER;
extern const CFStringRef kDRDeviceMediaTypeHDDVDRWDualLayerAVAILABLE_MAC_OS_X_VERSION_10_5_AND_LATER;
extern const CFStringRef kDRDeviceMediaTypeKeyAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
extern const CFStringRef kDRDeviceMediaTypeUnknownAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
extern const CFStringRef kDRDevicePhysicalInterconnectATAPIAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
extern const CFStringRef kDRDevicePhysicalInterconnectFibreChannelAVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER;
extern const CFStringRef kDRDevicePhysicalInterconnectFireWireAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
extern const CFStringRef kDRDevicePhysicalInterconnectKeyAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
extern const CFStringRef kDRDevicePhysicalInterconnectLocationExternalAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
extern const CFStringRef kDRDevicePhysicalInterconnectLocationInternalAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
extern const CFStringRef kDRDevicePhysicalInterconnectLocationKeyAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
extern const CFStringRef kDRDevicePhysicalInterconnectLocationUnknownAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
extern const CFStringRef kDRDevicePhysicalInterconnectSCSIAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
extern const CFStringRef kDRDevicePhysicalInterconnectUSBAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
extern const CFStringRef kDRDeviceProductNameKeyAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
extern const CFStringRef kDRDeviceStatusChangedNotificationAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
extern const CFStringRef kDRDeviceSupportLevelAppleShippingAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
extern const CFStringRef kDRDeviceSupportLevelAppleSupportedAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
extern const CFStringRef kDRDeviceSupportLevelKeyAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
extern const CFStringRef kDRDeviceSupportLevelNoneAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
extern const CFStringRef kDRDeviceSupportLevelUnsupportedAVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER;
extern const CFStringRef kDRDeviceSupportLevelVendorSupportedAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
extern const CFStringRef kDRDeviceTrackInfoKeyAVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER;
extern const CFStringRef kDRDeviceTrackRefsKeyAVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER;
extern const CFStringRef kDRDeviceVendorNameKeyAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
extern const CFStringRef kDRDeviceWriteBufferSizeKeyAVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER;
extern const CFStringRef kDRDeviceWriteCapabilitiesKeyAVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;
Constants
kDRDeviceAppearedNotification

Notification sent when a device has become available. Because users can connect and disconnect FireWire, USB, and other devices while a computer is on, you should maintain your own list of attached devices and rely on notifications to keep the list current.

Available in OS X v10.2 and later.

Declared in DRCoreDevice.h.

kDRDeviceBurnSpeedBD1x

A predefined value for the minimum BD burn speed of 4,496.0 kilobytes per second, where 1 kilobyte = 1,000 bytes.

Available in OS X v10.5 and later.

Declared in DRCoreDevice.h.

kDRDeviceBurnSpeedCD1x

A predefined value for the minimum CD burn speed of 176.4 kilobytes per second, where 1 kilobyte = 1,000 bytes.

Available in OS X v10.2 and later.

Declared in DRCoreDevice.h.

kDRDeviceBurnSpeedDVD1x

A predefined value for the minimum DVD burn speed of 1,385.0 kilobytes per second, where 1 kilobyte = 1,000 bytes.

Available in OS X v10.2 and later.

Declared in DRCoreDevice.h.

kDRDeviceBurnSpeedHDDVD1x

A predefined value for the minimum HD DVD burn speed of 4,496.0 kilobytes per second, where 1 kilobyte = 1,000 bytes.

Available in OS X v10.5 and later.

Declared in DRCoreDevice.h.

kDRDeviceBurnSpeedMax

A predefined value used to request the maximum speed at which a device can perform a burn. On receiving a burn request of kDRDeviceBurnSpeedMax, a drive selects the highest usable speed given its capabilities, the bus bandwidth, and the capabilities of the recordable disc.

Available in OS X v10.2 and later.

Declared in DRCoreDevice.h.

kDRDeviceBurnSpeedsKey

A key for the dictionary returned by DRDeviceCopyStatus . The value of this key is a reference to a CFArray object containing the available burn speeds. This key may not be accessible if there is no disc in the drive.

Available in OS X v10.2 and later.

Declared in DRCoreDevice.h.

kDRDeviceCanTestWriteCDKey

A key for the kDRDeviceWriteCapabilitiesKey dictionary in the device info dictionary. The value is a reference to a CFBoolean object indicating whether the device can perform a test write to CD media.

Available in OS X v10.2 and later.

Declared in DRCoreDevice.h.

kDRDeviceCanTestWriteDVDKey

A key for the kDRDeviceWriteCapabilitiesKey dictionary in the device info dictionary. The value is a reference to a CFBoolean object indicating whether the device can perform a test write to DVD media.

Available in OS X v10.2 and later.

Declared in DRCoreDevice.h.

kDRDeviceCanUnderrunProtectCDKey

A key for the kDRDeviceWriteCapabilitiesKey dictionary in the device info dictionary. The value is a reference to a CFBoolean object indicating whether the device has burn underrun protection when writing to CD media.

Available in OS X v10.2 and later.

Declared in DRCoreDevice.h.

kDRDeviceCanUnderrunProtectDVDKey

A key for the kDRDeviceWriteCapabilitiesKey dictionary in the device info dictionary. The value is a reference to a CFBoolean object indicating whether the device has burn underrun protection when writing to DVD media.

Available in OS X v10.2 and later.

Declared in DRCoreDevice.h.

kDRDeviceCanWriteBDKey

A key for the kDRDeviceWriteCapabilitiesKey dictionary in the device info dictionary. The value is a reference to a CFBoolean object indicating whether the device can write to some type of BD-based (Blu-ray) media.

Available in OS X v10.5 and later.

Declared in DRCoreDevice.h.

kDRDeviceCanWriteBDREKey

A key for the kDRDeviceWriteCapabilitiesKey dictionary in the device info dictionary. The value is a reference to a CFBoolean object indicating whether the device can write to BD-RE media.

Available in OS X v10.5 and later.

Declared in DRCoreDevice.h.

kDRDeviceCanWriteBDRKey

A key for the kDRDeviceWriteCapabilitiesKey dictionary in the device info dictionary. The value is a reference to a CFBoolean object indicating whether the device can write to BD-R media.

Available in OS X v10.5 and later.

Declared in DRCoreDevice.h.

kDRDeviceCanWriteCDKey

A key for the kDRDeviceWriteCapabilitiesKey dictionary in the device info dictionary. The value is a reference to a CFBoolean object indicating whether the device can write to some type of CD-based media.

Available in OS X v10.2 and later.

Declared in DRCoreDevice.h.

kDRDeviceCanWriteCDRawKey

A key for the kDRDeviceWriteCapabilitiesKey dictionary in the device info dictionary. The value is a reference to a CFBoolean object indicating whether the device supports a raw mode burn strategy for CD.

A raw mode burn writes client-defined lead-in, program area, and lead-out data to CD media in a single pass. It supports options such as single-pass writing of a multisession disc. The Multi-Media Command Set (MMC) standard name for this strategy is "raw" but it is often called disc-at-once (DAO).

Available in OS X v10.3 and later.

Declared in DRCoreDevice.h.

kDRDeviceCanWriteCDRKey

A key for the kDRDeviceWriteCapabilitiesKey dictionary in the device info dictionary. The value is a reference to a CFBoolean object indicating whether the device can write to CD-R media.

Available in OS X v10.2 and later.

Declared in DRCoreDevice.h.

kDRDeviceCanWriteCDRWKey

A key for the kDRDeviceWriteCapabilitiesKey dictionary in the device info dictionary. The value is a reference to a CFBoolean object indicating whether the device can write to CD-RW media.

Available in OS X v10.2 and later.

Declared in DRCoreDevice.h.

kDRDeviceCanWriteCDSAOKey

A key for the kDRDeviceWriteCapabilitiesKey dictionary in the device info dictionary. The value is a reference to a CFBoolean object indicating whether the device supports a session-at-once (SAO) burn strategy for CD.

Available in OS X v10.3 and later.

Declared in DRCoreDevice.h.

kDRDeviceCanWriteCDTAOKey

A key for the kDRDeviceWriteCapabilitiesKey dictionary in the device info dictionary. The value is a reference to a CFBoolean object indicating whether the device supports a track-at-once (TAO) burn strategy for CD.

Available in OS X v10.3 and later.

Declared in DRCoreDevice.h.

kDRDeviceCanWriteCDTextKey

A key for the kDRDeviceWriteCapabilitiesKey dictionary in the device info dictionary. The value is a reference to a CFBoolean object indicating whether the device can write CD-Text information.

Available in OS X v10.2 and later.

Declared in DRCoreDevice.h.

kDRDeviceCanWriteDVDDAOKey

A key for the kDRDeviceWriteCapabilitiesKey dictionary in the device info dictionary. The value is a reference to a CFBoolean object indicating whether the device supports a disc-at-once (DAO) burn strategy on DVD media. This burn strategy does not apply to CD media.

Available in OS X v10.3 and later.

Declared in DRCoreDevice.h.

kDRDeviceCanWriteDVDKey

A key for the kDRDeviceWriteCapabilitiesKey dictionary in the device info dictionary. The value is a reference to a CFBoolean object indicating whether the device can write to some type of DVD-based media.

Available in OS X v10.2 and later.

Declared in DRCoreDevice.h.

kDRDeviceCanWriteDVDPlusRDoubleLayerKey

A key for the kDRDeviceWriteCapabilitiesKey dictionary in the device info dictionary. The value is a reference to a CFBoolean object indicating whether the device can write to DVD+R double layer media.

Available in OS X v10.4 and later.

Declared in DRCoreDevice.h.

kDRDeviceCanWriteDVDPlusRKey

A key for the kDRDeviceWriteCapabilitiesKey dictionary in the device info dictionary. The value is a reference to a CFBoolean object indicating whether the device can write to DVD+R media.

Available in OS X v10.3 and later.

Declared in DRCoreDevice.h.

kDRDeviceCanWriteDVDPlusRWDoubleLayerKey

A key for the kDRDeviceWriteCapabilitiesKey dictionary in the device info dictionary. The value is a reference to a CFBoolean object indicating whether the device can write to DVD+RW double layer media.

Available in OS X v10.5 and later.

Declared in DRCoreDevice.h.

kDRDeviceCanWriteDVDPlusRWKey

A key for the kDRDeviceWriteCapabilitiesKey dictionary in the device info dictionary. The value is a reference to a CFBoolean object indicating whether the device can write to DVD+RW media.

Available in OS X v10.3 and later.

Declared in DRCoreDevice.h.

kDRDeviceCanWriteDVDRAMKey

A key for the kDRDeviceWriteCapabilitiesKey dictionary in the device info dictionary. The value is a reference to a CFBoolean object indicating whether the device can write to DVD-RAM media.

Available in OS X v10.2 and later.

Declared in DRCoreDevice.h.

kDRDeviceCanWriteDVDRDualLayerKey

A key for the kDRDeviceWriteCapabilitiesKey dictionary in the device info dictionary. The value is a reference to a CFBoolean object indicating whether the device can write to DVD-R DL media.

Available in OS X v10.5 and later.

Declared in DRCoreDevice.h.

kDRDeviceCanWriteDVDRKey

A key for the kDRDeviceWriteCapabilitiesKey dictionary in the device info dictionary. The value is a reference to a CFBoolean object indicating whether the device can write to DVD-R media.

Available in OS X v10.2 and later.

Declared in DRCoreDevice.h.

kDRDeviceCanWriteDVDRWDualLayerKey

A key for the kDRDeviceWriteCapabilitiesKey dictionary in the device info dictionary. The value is a reference to a CFBoolean object indicating whether the device can write to DVD-RW DL media.

Available in OS X v10.5 and later.

Declared in DRCoreDevice.h.

kDRDeviceCanWriteDVDRWKey

A key for the kDRDeviceWriteCapabilitiesKey dictionary in the device info dictionary. The value is a reference to a CFBoolean object indicating whether the device can write to DVD-RW media.

Available in OS X v10.2 and later.

Declared in DRCoreDevice.h.

kDRDeviceCanWriteHDDVDKey

A key for the kDRDeviceWriteCapabilitiesKey dictionary in the device info dictionary. The value is a reference to a CFBoolean object indicating whether the device can write to some type of HD DVD-based media.

Available in OS X v10.5 and later.

Declared in DRCoreDevice.h.

kDRDeviceCanWriteHDDVDRAMKey

A key for the kDRDeviceWriteCapabilitiesKey dictionary in the device info dictionary. The value is a reference to a CFBoolean object indicating whether the device can write to HD DVD-RAM media.

Available in OS X v10.5 and later.

Declared in DRCoreDevice.h.

kDRDeviceCanWriteHDDVDRDualLayerKey

A key for the kDRDeviceWriteCapabilitiesKey dictionary in the device info dictionary. The value is a reference to a CFBoolean object indicating whether the device can write to HD DVD-R DL media.

Available in OS X v10.5 and later.

Declared in DRCoreDevice.h.

kDRDeviceCanWriteHDDVDRKey

A key for the kDRDeviceWriteCapabilitiesKey dictionary in the device info dictionary. The value is a reference to a CFBoolean object indicating whether the device can write to HD DVD-R media.

Available in OS X v10.5 and later.

Declared in DRCoreDevice.h.

kDRDeviceCanWriteHDDVDRWDualLayerKey

A key for the kDRDeviceWriteCapabilitiesKey dictionary in the device info dictionary. The value is a reference to a CFBoolean object indicating whether the device can write to HD DVD-RW DL media.

Available in OS X v10.5 and later.

Declared in DRCoreDevice.h.

kDRDeviceCanWriteHDDVDRWKey

A key for the kDRDeviceWriteCapabilitiesKey dictionary in the device info dictionary. The value is a reference to a CFBoolean object indicating whether the device can write to HD DVD-RW media.

Available in OS X v10.5 and later.

Declared in DRCoreDevice.h.

kDRDeviceCanWriteIndexPointsKey

A key for the kDRDeviceWriteCapabilitiesKey dictionary in the device info dictionary. The value is a reference to a CFBoolean object indicating whether the device can write index points to CD media.

Available in OS X v10.3 and later.

Declared in DRCoreDevice.h.

kDRDeviceCanWriteISRCKey

A key for the kDRDeviceWriteCapabilitiesKey dictionary in the device info dictionary. The value is a reference to a CFBoolean object indicating whether the device can write International Standard Recording Code (ISRC) to CD media.

Available in OS X v10.3 and later.

Declared in DRCoreDevice.h.

kDRDeviceCanWriteKey

A key for the kDRDeviceWriteCapabilitiesKey dictionary in the device info dictionary. The value is a reference to a CFBoolean object indicating whether the device can write to any type of media.

Available in OS X v10.2 and later.

Declared in DRCoreDevice.h.

kDRDeviceCurrentWriteSpeedKey

A key for the dictionary returned by DRDeviceCopyStatus . The value of this key is a reference to a CFNumber object containing the current write speed in KB/s, where 1KB = 1000 bytes.

Available in OS X v10.2 and later.

Declared in DRCoreDevice.h.

kDRDeviceDisappearedNotification

Notification sent when a device is no longer available. Because users can connect and disconnect FireWire, USB, and other devices while a computer is on, you should maintain your own list of attached devices and rely on notifications to keep the list current.

Available in OS X v10.2 and later.

Declared in DRCoreDevice.h.

kDRDeviceFirmwareRevisionKey

A key for the dictionary object returned by DRDeviceCopyInfo . The value of this key is a reference to a CFString object containing the firmware revision extracted from the device.

Available in OS X v10.2 and later.

Declared in DRCoreDevice.h.

kDRDeviceIORegistryEntryPathKey

A key for the dictionary object returned by DRDeviceCopyInfo . The value of this key is a reference to a CFString object containing a copy of the path to the device entry in the IORegistry.

Available in OS X v10.2 and later.

Declared in DRCoreDevice.h.

kDRDeviceIsBusyKey

A key for the dictionary returned by DRDeviceCopyStatus . The value of this key is a reference to a CFBoolean object indicating if the device is busy.

Available in OS X v10.2 and later.

Declared in DRCoreDevice.h.

kDRDeviceIsTrayOpenKey

A key for the dictionary returned by DRDeviceCopyStatus . The value of this key is a reference to a CFBoolean object indicating if the device's tray is open.

Available in OS X v10.2 and later.

Declared in DRCoreDevice.h.

kDRDeviceLoadingMechanismCanEjectKey

A key for the dictionary object returned by DRDeviceCopyInfo . The value of this key is a reference to a CFBoolean object that indicates if the loading mechanism of the drive can eject.

Available in OS X v10.3 and later.

Declared in DRCoreDevice.h.

kDRDeviceLoadingMechanismCanInjectKey

A key for the dictionary object returned by DRDeviceCopyInfo . The value of this key is a reference to a CFBoolean object that indicates if the loading mechanism of the drive can inject.

Available in OS X v10.3 and later.

Declared in DRCoreDevice.h.

kDRDeviceLoadingMechanismCanOpenKey

A key for the dictionary object returned by DRDeviceCopyInfo . The value of this key is a reference to a CFBoolean object that indicates if the loading mechanism of the drive can open.

Available in OS X v10.3 and later.

Declared in DRCoreDevice.h.

kDRDeviceMaximumWriteSpeedKey

A key for the dictionary returned by DRDeviceCopyStatus . The value of this key is a reference to a CFNumber object containing the maximum write speed in KB/s, where 1KB = 1000 bytes.

Available in OS X v10.2 and later.

Declared in DRCoreDevice.h.

kDRDeviceMediaBlocksFreeKey

A key in the kDRDeviceMediaInfoKey dictionary. The value of this key is a reference to a CFNumber object containing the number of free blocks on the disc.

Available in OS X v10.2 and later.

Declared in DRCoreDevice.h.

kDRDeviceMediaBlocksOverwritableKey

A key in the kDRDeviceMediaInfoKey dictionary. The value of this key is a reference to a CFNumber object containing the number of writable blocks on the disc.

Available in OS X v10.3 and later.

Declared in DRCoreDevice.h.

kDRDeviceMediaBlocksUsedKey

A key in the kDRDeviceMediaInfoKey dictionary. The value of this key is a reference to a CFNumber object containing the number of blocks used by data on the disc.

Available in OS X v10.2 and later.

Declared in DRCoreDevice.h.

kDRDeviceMediaBSDNameKey

A key in the kDRDeviceMediaInfoKey dictionary. The value of this key is a reference to a CFString object containing the BSD name assigned to the device.

Available in OS X v10.2 and later.

Declared in DRCoreDevice.h.

kDRDeviceMediaClassBD

One value for the kDRDeviceMediaClassKey dictionary key in the kDRDeviceMediaInfoKey dictionary. This value indicates that the disc is BD-based (Blu-ray).

Available in OS X v10.5 and later.

Declared in DRCoreDevice.h.

kDRDeviceMediaClassCD

One value for the kDRDeviceMediaClassKey dictionary key in the kDRDeviceMediaInfoKey dictionary. This value indicates that the disc is CD-based.

Available in OS X v10.2 and later.

Declared in DRCoreDevice.h.

kDRDeviceMediaClassDVD

One value for the kDRDeviceMediaClassKey dictionary key in the kDRDeviceMediaInfoKey dictionary. This value indicates that the disc is DVD-based.

Available in OS X v10.2 and later.

Declared in DRCoreDevice.h.

kDRDeviceMediaClassHDDVD

One value for the kDRDeviceMediaClassKey dictionary key in the kDRDeviceMediaInfoKey dictionary. This value indicates that the disc is HD DVD-based.

Available in OS X v10.5 and later.

Declared in DRCoreDevice.h.

kDRDeviceMediaClassKey

A key for the kDRDeviceMediaInfoKey dictionary. The value of this key is a reference to a CFString object indicating the class of media present in the drive.

Available in OS X v10.2 and later.

Declared in DRCoreDevice.h.

kDRDeviceMediaClassUnknown

One value for the kDRDeviceMediaClassKey dictionary key in the kDRDeviceMediaInfoKey dictionary. This value indicates that the media class is unknown.

Available in OS X v10.2 and later.

Declared in DRCoreDevice.h.

kDRDeviceMediaDoubleLayerL0DataZoneBlocksKey

A key in the kDRDeviceMediaInfoKey dictionary. The value of this key is a reference to a CFNumber object containing the number of blocks on layer 0 of a double layer burnable disc.

Available in OS X v10.4 and later.

Declared in DRCoreDevice.h.

kDRDeviceMediaInfoKey

A key for the dictionary returned by DRDeviceCopyStatus . The value of this key is a reference to a CFDictionary object containing information about the media in the drive.

Available in OS X v10.2 and later.

Declared in DRCoreDevice.h.

kDRDeviceMediaIsAppendableKey

A key in the kDRDeviceMediaInfoKey dictionary. The value of this key is a reference to a CFBoolean object indicating whether the disc is appendable -- in other words, whether new sessions can be written.

Available in OS X v10.2 and later.

Declared in DRCoreDevice.h.

kDRDeviceMediaIsBlankKey

A key in the kDRDeviceMediaInfoKey dictionary. The value of this key is a reference to a CFBoolean object indicating whether the media is blank and has no data on it.

Available in OS X v10.2 and later.

Declared in DRCoreDevice.h.

kDRDeviceMediaIsErasableKey

A key in the kDRDeviceMediaInfoKey dictionary. The value of this key is a reference to a CFBoolean object indicating whether the disc can be erased.

Available in OS X v10.2 and later.

Declared in DRCoreDevice.h.

kDRDeviceMediaIsOverwritableKey

A key in the kDRDeviceMediaInfoKey dictionary. The value of this key is a reference to a CFBoolean object indicating whether the disc is writable -- in other words, whether it can be fully (re)written.

Available in OS X v10.3 and later.

Declared in DRCoreDevice.h.

kDRDeviceMediaIsReservedKey

A key in the kDRDeviceMediaInfoKey dictionary. The value of this key is a reference to a CFBoolean object indicating whether the disc is reserved for exclusive use by the current process.

Available in OS X v10.2 and later.

Declared in DRCoreDevice.h.

kDRDeviceMediaSessionCountKey

A key in the kDRDeviceMediaInfoKey dictionary. The value of this key is a reference to a CFNumber object containing the number of sessions on the disc.

Available in OS X v10.2 and later.

Declared in DRCoreDevice.h.

kDRDeviceMediaStateInTransition

One value for the kDRDeviceMediaStateKey dictionary key. This value indicates that the media is in transition, typically spinning up after being inserted or spinning down in preparation for ejecting.

Available in OS X v10.2 and later.

Declared in DRCoreDevice.h.

kDRDeviceMediaStateKey

A key for the dictionary returned by DRDeviceCopyStatus . The value of this key is a reference to a CFString object containing information about the state of the media.

Available in OS X v10.2 and later.

Declared in DRCoreDevice.h.

kDRDeviceMediaStateMediaPresent

One value for the kDRDeviceMediaStateKey dictionary key. This value indicates that some kind of media is present in the drive. Check the value of the kDRDeviceMediaInfoKey dictionary key for specific media information.

Available in OS X v10.2 and later.

Declared in DRCoreDevice.h.

kDRDeviceMediaStateNone

One value for the kDRDeviceMediaStateKey dictionary key. This value indicates that there is no disc present in the drive.

Available in OS X v10.2 and later.

Declared in DRCoreDevice.h.

kDRDeviceMediaTrackCountKey

A key in the kDRDeviceMediaInfoKey dictionary. The value of this key is a reference to a CFNumber object containing the total number of tracks on the disc in all sessions.

Available in OS X v10.2 and later.

Declared in DRCoreDevice.h.

kDRDeviceMediaTypeBDR

One value for the kDRDeviceMediaTypeKey dictionary key in the kDRDeviceMediaInfoKey dictionary. This value indicates that the disc is a BD-R.

Available in OS X v10.5 and later.

Declared in DRCoreDevice.h.

kDRDeviceMediaTypeBDR

One value for the kDRDeviceMediaTypeKey dictionary key in the kDRDeviceMediaInfoKey dictionary. This value indicates that the disc is a BD-RE.

Available in OS X v10.5 and later.

Declared in DRCoreDevice.h.

kDRDeviceMediaTypeBDRE

One value for the kDRDeviceMediaTypeKey dictionary key in the kDRDeviceMediaInfoKey dictionary. This value indicates that the disc is a BD-RE.

Available in OS X v10.5 and later.

Declared in DRCoreDevice.h.

kDRDeviceMediaTypeBDROM

One value for the kDRDeviceMediaTypeKey dictionary key in the kDRDeviceMediaInfoKey dictionary. This value indicates that the disc is a BD-ROM.

Available in OS X v10.5 and later.

Declared in DRCoreDevice.h.

kDRDeviceMediaTypeCDR

One value for the kDRDeviceMediaTypeKey dictionary key in the kDRDeviceMediaInfoKey dictionary. This value indicates that the disc is a CD-R.

Available in OS X v10.2 and later.

Declared in DRCoreDevice.h.

kDRDeviceMediaTypeCDROM

One value for the kDRDeviceMediaTypeKey dictionary key in the kDRDeviceMediaInfoKey dictionary. This value indicates that the disc is a CD-ROM.

Available in OS X v10.2 and later.

Declared in DRCoreDevice.h.

kDRDeviceMediaTypeCDRW

One value for the kDRDeviceMediaTypeKey dictionary key in the kDRDeviceMediaInfoKey dictionary. This value indicates that the disc is a CD-RW.

Available in OS X v10.2 and later.

Declared in DRCoreDevice.h.

kDRDeviceMediaTypeDVDPlusR

One value for the kDRDeviceMediaTypeKey dictionary key in the kDRDeviceMediaInfoKey dictionary. This value indicates that the disc is a DVD+R.

Available in OS X v10.3 and later.

Declared in DRCoreDevice.h.

kDRDeviceMediaTypeDVDPlusRDoubleLayer

One value for the kDRDeviceMediaTypeKey dictionary key in the media info dictionary. This value indicates that the disc is a DVD+R Double Layer.

Available in OS X v10.4 and later.

Declared in DRCoreDevice.h.

kDRDeviceMediaTypeDVDPlusRW

One value for the kDRDeviceMediaTypeKey dictionary key in the kDRDeviceMediaInfoKey dictionary. This value indicates that the disc is a DVD+RW.

Available in OS X v10.2 and later.

Declared in DRCoreDevice.h.

kDRDeviceMediaTypeDVDPlusRWDoubleLayer

One value for the kDRDeviceMediaTypeKey dictionary key in the media info dictionary. This value indicates that the disc is a DVD+RW Double Layer.

Available in OS X v10.5 and later.

Declared in DRCoreDevice.h.

kDRDeviceMediaTypeDVDR

One value for the kDRDeviceMediaTypeKey dictionary key in the kDRDeviceMediaInfoKey dictionary. This value indicates that the disc is a DVD-R.

Available in OS X v10.2 and later.

Declared in DRCoreDevice.h.

kDRDeviceMediaTypeDVDRAM

One value for the kDRDeviceMediaTypeKey dictionary key in the kDRDeviceMediaInfoKey dictionary. This value indicates that the disc is a DVD-RAM.

Available in OS X v10.2 and later.

Declared in DRCoreDevice.h.

kDRDeviceMediaTypeDVDRDualLayer

One value for the kDRDeviceMediaTypeKey dictionary key in the kDRDeviceMediaInfoKey dictionary. This value indicates that the disc is a DVD-R DL.

Available in OS X v10.5 and later.

Declared in DRCoreDevice.h.

kDRDeviceMediaTypeDVDROM

One value for the kDRDeviceMediaTypeKey dictionary key in the kDRDeviceMediaInfoKey dictionary. This value indicates that the disc is a DVD-ROM.

Available in OS X v10.2 and later.

Declared in DRCoreDevice.h.

kDRDeviceMediaTypeDVDRW

One value for the kDRDeviceMediaTypeKey dictionary key in the kDRDeviceMediaInfoKey dictionary. This value indicates that the disc is a DVD-RW.

Available in OS X v10.2 and later.

Declared in DRCoreDevice.h.

kDRDeviceMediaTypeDVDRWDualLayer

One value for the kDRDeviceMediaTypeKey dictionary key in the kDRDeviceMediaInfoKey dictionary. This value indicates that the disc is a DVD-RW DL.

Available in OS X v10.5 and later.

Declared in DRCoreDevice.h.

kDRDeviceMediaTypeHDDVDR

One value for the kDRDeviceMediaTypeKey dictionary key in the kDRDeviceMediaInfoKey dictionary. This value indicates that the disc is a HD DVD-R.

Available in OS X v10.5 and later.

Declared in DRCoreDevice.h.

kDRDeviceMediaTypeHDDVDRAM

One value for the kDRDeviceMediaTypeKey dictionary key in the kDRDeviceMediaInfoKey dictionary. This value indicates that the disc is a HD DVD-RAM.

Available in OS X v10.5 and later.

Declared in DRCoreDevice.h.

kDRDeviceMediaTypeHDDVDRDualLayer

One value for the kDRDeviceMediaTypeKey dictionary key in the kDRDeviceMediaInfoKey dictionary. This value indicates that the disc is a HD DVD-R DL.

Available in OS X v10.5 and later.

Declared in DRCoreDevice.h.

kDRDeviceMediaTypeHDDVDROM

One value for the kDRDeviceMediaTypeKey dictionary key in the kDRDeviceMediaInfoKey dictionary. This value indicates that the disc is a HD DVD-ROM.

Available in OS X v10.5 and later.

Declared in DRCoreDevice.h.

kDRDeviceMediaTypeHDDVDRW

One value for the kDRDeviceMediaTypeKey dictionary key in the kDRDeviceMediaInfoKey dictionary. This value indicates that the disc is a HD DVD-RW.

Available in OS X v10.5 and later.

Declared in DRCoreDevice.h.

kDRDeviceMediaTypeHDDVDRWDualLayer

One value for the kDRDeviceMediaTypeKey dictionary key in the kDRDeviceMediaInfoKey dictionary. This value indicates that the disc is a HD DVD-RW DL.

Available in OS X v10.5 and later.

Declared in DRCoreDevice.h.

kDRDeviceMediaTypeKey

A key in the kDRDeviceMediaInfoKey dictionary. The value of this key is a reference to a CFString object indicating the type of media present in the drive.

Available in OS X v10.2 and later.

Declared in DRCoreDevice.h.

kDRDeviceMediaTypeUnknown

One value for the kDRDeviceMediaTypeKey dictionary key in the kDRDeviceMediaInfoKey dictionary. This value indicates that the disc type is unknown.

Available in OS X v10.2 and later.

Declared in DRCoreDevice.h.

kDRDevicePhysicalInterconnectATAPI

One value for the kDRDevicePhysicalInterconnectKey dictionary key. This value indicates that the device is connected by an ATAPI interface.

Available in OS X v10.2 and later.

Declared in DRCoreDevice.h.

kDRDevicePhysicalInterconnectFibreChannel

One value for the kDRDevicePhysicalInterconnectKey dictionary key. This value indicates that the device is connected by a Fibre Channel interface.

Available in OS X v10.3 and later.

Declared in DRCoreDevice.h.

kDRDevicePhysicalInterconnectFireWire

One value for the kDRDevicePhysicalInterconnectKey dictionary key. This value indicates that the device is connected by a FireWire interface.

Available in OS X v10.2 and later.

Declared in DRCoreDevice.h.

kDRDevicePhysicalInterconnectKey

A key for the dictionary object returned by DRDeviceCopyInfo . The value of this key is a reference to a CFString object containing the type of the bus the device is on.

Available in OS X v10.2 and later.

Declared in DRCoreDevice.h.

kDRDevicePhysicalInterconnectLocationExternal

One value for the kDRDevicePhysicalInterconnectLocationKey dictionary key. This value indicates that the device is on an external bus.

Available in OS X v10.2 and later.

Declared in DRCoreDevice.h.

kDRDevicePhysicalInterconnectLocationInternal

One value for the kDRDevicePhysicalInterconnectLocationKey dictionary key. This value indicates that the device is on an internal bus.

Available in OS X v10.2 and later.

Declared in DRCoreDevice.h.

kDRDevicePhysicalInterconnectLocationKey

A key for the dictionary object returned by DRDeviceCopyInfo . The value of this key is a reference to a CFString object containing the physical interconnect location.

Available in OS X v10.2 and later.

Declared in DRCoreDevice.h.

kDRDevicePhysicalInterconnectLocationUnknown

One value for the kDRDevicePhysicalInterconnectLocationKey dictionary key. This value indicates that the software cannot determine whether the device is on an internal or external bus.

Available in OS X v10.2 and later.

Declared in DRCoreDevice.h.

kDRDevicePhysicalInterconnectSCSI

One value for the kDRDevicePhysicalInterconnectKey dictionary key. This value indicates that the device is connected by a SCSI interface.

Available in OS X v10.2 and later.

Declared in DRCoreDevice.h.

kDRDevicePhysicalInterconnectUSB

One value for the kDRDevicePhysicalInterconnectKey dictionary key. This value indicates that the device is connected by a USB interface.

Available in OS X v10.2 and later.

Declared in DRCoreDevice.h.

kDRDeviceProductNameKey

A key for the dictionary object returned by DRDeviceCopyInfo . The value of this key is a reference to a CFString object containing the product name extracted from the device.

Available in OS X v10.2 and later.

Declared in DRCoreDevice.h.

kDRDeviceStatusChangedNotification

Notification sent when a device's status changes, usually because a disc has been inserted or removed. The value of the info parameter for your notification callback is equivalent to the dictionary object reference returned from a call to DRDeviceCopyStatus .

Available in OS X v10.2 and later.

Declared in DRCoreDevice.h.

kDRDeviceSupportLevelAppleShipping

One value for the kDRDeviceSupportLevelKey dictionary key. This value indicates that Apple has provided support for the device and it has shipped in a machine made by Apple.

Available in OS X v10.2 and later.

Declared in DRCoreDevice.h.

kDRDeviceSupportLevelAppleSupported

One value for the kDRDeviceSupportLevelKey dictionary key. This value indicates that Apple has provided support for the device.

Available in OS X v10.2 and later.

Declared in DRCoreDevice.h.

kDRDeviceSupportLevelKey

A key for the dictionary object returned by DRDeviceCopyInfo . The value of this key is a reference to a CFString object indicating how well the engine supports the device.

Available in OS X v10.2 and later.

Declared in DRCoreDevice.h.

kDRDeviceSupportLevelNone

One value for the kDRDeviceSupportLevelKey dictionary key. This value indicates the engine does not support the device and it cannot be used.

Available in OS X v10.2 and later.

Declared in DRCoreDevice.h.

kDRDeviceSupportLevelUnsupported

One value for the kDRDeviceSupportLevelKey dictionary key. This value indicates the device is unsupported but the Disc Recording engine will try to use it anyway.

Available in OS X v10.3 and later.

Declared in DRCoreDevice.h.

kDRDeviceSupportLevelVendorSupported

One value for the kDRDeviceSupportLevelKey dictionary key. This value indicates the device vendor has provided support for the device.

Available in OS X v10.2 and later.

Declared in DRCoreDevice.h.

kDRDeviceTrackInfoKey

A key for the dictionary returned by DRDeviceCopyStatus . The value of this key is a reference to a CFDictionary object containing dictionaries describing on-disc tracks. DRTrackRef dictionaries from the kDRDeviceTrackRefsKey constant are used as keys into this dictionary.

Available in OS X v10.3 and later.

Declared in DRCoreDevice.h.

kDRDeviceTrackRefsKey

A key for the dictionary returned by DRDeviceCopyStatus . The value of this key is a reference to a CFArray object containing a list of DRTrack objects describing any tracks that are already on the disc.

Available in OS X v10.3 and later.

Declared in DRCoreDevice.h.

kDRDeviceVendorNameKey

A key for the dictionary object returned by DRDeviceCopyInfo . The value of this key is a reference to a CFString object containing the vendor name extracted from the device.

Available in OS X v10.2 and later.

Declared in DRCoreDevice.h.

kDRDeviceWriteBufferSizeKey

A key for the dictionary object returned by DRDeviceCopyInfo . The value of this key is a reference to a CFNumber object containing the size of the write buffer of the device.

Available in OS X v10.3 and later.

Declared in DRCoreDevice.h.

kDRDeviceWriteCapabilitiesKey

A key for the dictionary object returned by DRDeviceCopyInfo . The value of this key is a reference to a CFString object describing the capabilities the drive has for writing to different media.

Available in OS X v10.2 and later.

Declared in DRCoreDevice.h.