DRCoreDevice.h

Overview

Device interfaces for Disc Recording.

Functions

DRCopyDeviceArray

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

DRDeviceAcquireExclusiveAccess

Attempts to acquire an exclusive access session with the device.

DRDeviceAcquireMediaReservation

Indicates an interest in reserving blank media.

DRDeviceCloseTray

Commands a device to close its tray.

DRDeviceCopyDeviceForBSDName

Returns the device reference corresponding to the BSD device name.

DRDeviceCopyDeviceForIORegistryEntryPath

Returns the device reference corresponding to the IORegistry entry.

DRDeviceCopyInfo

Returns information about the device.

DRDeviceCopyStatus

Returns the status of the device.

DRDeviceEjectMedia

Commands a device to unmount and eject media.

DRDeviceGetTypeID

Returns the type identifier of all DRDevice instances.

DRDeviceIsValid

Determines whether the device is still attached and turned on.

DRDeviceKPSForXFactor

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

DRDeviceOpenTray

Commands a device to open up its tray.

DRDeviceReleaseExclusiveAccess

Release exclusive access to a device.

DRDeviceReleaseMediaReservation

Rescind an interest in the blank media reservation.

DRDeviceXFactorForKPS

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

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

extern CFArrayRef DRCopyDeviceArray(
    void) ;  

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

Introduced in Mac OS X v10.2

Attempts to acquire an exclusive access session with the device.

extern OSStatus DRDeviceAcquireExclusiveAccess(
    DRDeviceRef device) ;  

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

Introduced in Mac OS X v10.2

Indicates an interest in reserving blank media.

extern void DRDeviceAcquireMediaReservation(
    DRDeviceRef device) ;  

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

Introduced in Mac OS X v10.2

Commands a device to close its tray.

extern OSStatus DRDeviceCloseTray(
    DRDeviceRef device) ;  

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

Introduced in Mac OS X v10.2

Returns the device reference corresponding to the BSD device name.

extern DRDeviceRef DRDeviceCopyDeviceForBSDName(
    CFStringRef name) ;  

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

Introduced in Mac OS X v10.2

Returns the device reference corresponding to the IORegistry entry.

extern DRDeviceRef DRDeviceCopyDeviceForIORegistryEntryPath(
    CFStringRef path) ;  

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

Introduced in Mac OS X v10.2

Returns information about the device.

extern CFDictionaryRef DRDeviceCopyInfo(
    DRDeviceRef device) ;  

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

Introduced in Mac OS X v10.2

Returns the status of the device.

extern CFDictionaryRef DRDeviceCopyStatus(
    DRDeviceRef device) ;  

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

Introduced in Mac OS X v10.2

Commands a device to unmount and eject media.

extern OSStatus DRDeviceEjectMedia(
    DRDeviceRef device) ;  

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

Introduced in Mac OS X v10.2

Returns the type identifier of all DRDevice instances.

extern CFTypeID DRDeviceGetTypeID(
    void) ;  

Availability

Introduced in Mac OS X v10.2

Determines whether the device is still attached and turned on.

extern Boolean DRDeviceIsValid(
    DRDeviceRef device) ;  

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

Introduced in Mac OS X v10.2

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

extern float DRDeviceKPSForXFactor(
    DRTypeRef deviceOrMediaType,
    float xfactor) ;  

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

Introduced in Mac OS X v10.5.

Commands a device to open up its tray.

extern OSStatus DRDeviceOpenTray(
    DRDeviceRef device) ;  

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

Introduced in Mac OS X v10.2

Release exclusive access to a device.

extern void DRDeviceReleaseExclusiveAccess(
    DRDeviceRef device) ;  

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

Introduced in Mac OS X v10.2

Rescind an interest in the blank media reservation.

extern void DRDeviceReleaseMediaReservation(
    DRDeviceRef device) ;  

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

Introduced in Mac OS X v10.2

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

extern float DRDeviceXFactorForKPS(
    DRTypeRef deviceOrMediaType,
    float kps) ;  

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

Introduced in Mac OS X v10.5.

Constants

extern const CFStringRef kDRDeviceAppearedNotification;  

Discussion

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.

Availability

Introduced in Mac OS X v10.2

extern const float kDRDeviceBurnSpeedBD1x;  

Discussion

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

Availability

Introduced in Mac OS X v10.5.

extern const float kDRDeviceBurnSpeedCD1x;  

Discussion

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

Availability

Introduced in Mac OS X v10.2

extern const float kDRDeviceBurnSpeedDVD1x;  

Discussion

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

Availability

Introduced in Mac OS X v10.2

extern const float kDRDeviceBurnSpeedHDDVD1x;  

Discussion

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

Availability

Introduced in Mac OS X v10.5.

extern const float kDRDeviceBurnSpeedMax;  

Discussion

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.

Availability

Introduced in Mac OS X v10.2

extern const CFStringRef kDRDeviceBurnSpeedsKey;  

Discussion

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.

Availability

Introduced in Mac OS X v10.2

extern const CFStringRef kDRDeviceCanTestWriteCDKey;  

Discussion

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.

Availability

Introduced in Mac OS X v10.2

extern const CFStringRef kDRDeviceCanTestWriteDVDKey;  

Discussion

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.

Availability

Introduced in Mac OS X v10.2

extern const CFStringRef kDRDeviceCanUnderrunProtectCDKey;  

Discussion

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.

Availability

Introduced in Mac OS X v10.2

extern const CFStringRef kDRDeviceCanUnderrunProtectDVDKey;  

Discussion

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.

Availability

Introduced in Mac OS X v10.2

extern const CFStringRef kDRDeviceCanWriteBDKey;  

Discussion

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.

Availability

Introduced in Mac OS X v10.5.

extern const CFStringRef kDRDeviceCanWriteBDREKey;  

Discussion

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.

Availability

Introduced in Mac OS X v10.5.

extern const CFStringRef kDRDeviceCanWriteBDRKey;  

Discussion

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.

Availability

Introduced in Mac OS X v10.5.

extern const CFStringRef kDRDeviceCanWriteCDKey;  

Discussion

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.

Availability

Introduced in Mac OS X v10.2

extern const CFStringRef kDRDeviceCanWriteCDRawKey;  

Discussion

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

Availability

Introduced in Mac OS X v10.3.

extern const CFStringRef kDRDeviceCanWriteCDRKey;  

Discussion

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.

Availability

Introduced in Mac OS X v10.2

extern const CFStringRef kDRDeviceCanWriteCDRWKey;  

Discussion

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.

Availability

Introduced in Mac OS X v10.2

extern const CFStringRef kDRDeviceCanWriteCDSAOKey;  

Discussion

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.

Availability

Introduced in Mac OS X v10.3.

extern const CFStringRef kDRDeviceCanWriteCDTAOKey;  

Discussion

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.

Availability

Introduced in Mac OS X v10.3.

extern const CFStringRef kDRDeviceCanWriteCDTextKey;  

Discussion

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.

Availability

Introduced in Mac OS X v10.2

extern const CFStringRef kDRDeviceCanWriteDVDDAOKey;  

Discussion

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.

Availability

Introduced in Mac OS X v10.3.

extern const CFStringRef kDRDeviceCanWriteDVDKey;  

Discussion

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.

Availability

Introduced in Mac OS X v10.2

extern const CFStringRef kDRDeviceCanWriteDVDPlusRDoubleLayerKey;  

Discussion

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.

Availability

Introduced in Mac OS X v10.4.

extern const CFStringRef kDRDeviceCanWriteDVDPlusRKey;  

Discussion

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.

Availability

Introduced in Mac OS X v10.3.

extern const CFStringRef kDRDeviceCanWriteDVDPlusRWDoubleLayerKey;  

Discussion

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.

Availability

Introduced in Mac OS X v10.5.

extern const CFStringRef kDRDeviceCanWriteDVDPlusRWKey;  

Discussion

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.

Availability

Introduced in Mac OS X v10.3.

extern const CFStringRef kDRDeviceCanWriteDVDRAMKey;  

Discussion

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.

Availability

Introduced in Mac OS X v10.2

extern const CFStringRef kDRDeviceCanWriteDVDRDualLayerKey;  

Discussion

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.

Availability

Introduced in Mac OS X v10.5.

extern const CFStringRef kDRDeviceCanWriteDVDRKey;  

Discussion

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.

Availability

Introduced in Mac OS X v10.2

extern const CFStringRef kDRDeviceCanWriteDVDRWDualLayerKey;  

Discussion

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.

Availability

Introduced in Mac OS X v10.5.

extern const CFStringRef kDRDeviceCanWriteDVDRWKey;  

Discussion

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.

Availability

Introduced in Mac OS X v10.2

extern const CFStringRef kDRDeviceCanWriteHDDVDKey;  

Discussion

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.

Availability

Introduced in Mac OS X v10.5.

extern const CFStringRef kDRDeviceCanWriteHDDVDRAMKey;  

Discussion

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.

Availability

Introduced in Mac OS X v10.5.

extern const CFStringRef kDRDeviceCanWriteHDDVDRDualLayerKey;  

Discussion

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.

Availability

Introduced in Mac OS X v10.5.

extern const CFStringRef kDRDeviceCanWriteHDDVDRKey;  

Discussion

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.

Availability

Introduced in Mac OS X v10.5.

extern const CFStringRef kDRDeviceCanWriteHDDVDRWDualLayerKey;  

Discussion

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.

Availability

Introduced in Mac OS X v10.5.

extern const CFStringRef kDRDeviceCanWriteHDDVDRWKey;  

Discussion

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.

Availability

Introduced in Mac OS X v10.5.

extern const CFStringRef kDRDeviceCanWriteIndexPointsKey;  

Discussion

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.

Availability

Introduced in Mac OS X v10.3.

extern const CFStringRef kDRDeviceCanWriteISRCKey;  

Discussion

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.

Availability

Introduced in Mac OS X v10.3.

extern const CFStringRef kDRDeviceCanWriteKey;  

Discussion

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.

Availability

Introduced in Mac OS X v10.2

extern const CFStringRef kDRDeviceCurrentWriteSpeedKey;  

Discussion

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.

Availability

Introduced in Mac OS X v10.2

extern const CFStringRef kDRDeviceDisappearedNotification;  

Discussion

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.

Availability

Introduced in Mac OS X v10.2

extern const CFStringRef kDRDeviceFirmwareRevisionKey;  

Discussion

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.

Availability

Introduced in Mac OS X v10.2

extern const CFStringRef kDRDeviceIORegistryEntryPathKey;  

Discussion

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.

Availability

Introduced in Mac OS X v10.2

extern const CFStringRef kDRDeviceIsBusyKey;  

Discussion

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.

Availability

Introduced in Mac OS X v10.2

extern const CFStringRef kDRDeviceIsTrayOpenKey;  

Discussion

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.

Availability

Introduced in Mac OS X v10.2

extern const CFStringRef kDRDeviceLoadingMechanismCanEjectKey;  

Discussion

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.

Availability

Introduced in Mac OS X v10.3.

extern const CFStringRef kDRDeviceLoadingMechanismCanInjectKey;  

Discussion

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.

Availability

Introduced in Mac OS X v10.3.

extern const CFStringRef kDRDeviceLoadingMechanismCanOpenKey;  

Discussion

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.

Availability

Introduced in Mac OS X v10.3.

extern const CFStringRef kDRDeviceMaximumWriteSpeedKey;  

Discussion

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.

Availability

Introduced in Mac OS X v10.2

extern const CFStringRef kDRDeviceMediaBlocksFreeKey;  

Discussion

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.

Availability

Introduced in Mac OS X v10.2

extern const CFStringRef kDRDeviceMediaBlocksOverwritableKey;  

Discussion

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.

Availability

Introduced in Mac OS X v10.3.

extern const CFStringRef kDRDeviceMediaBlocksUsedKey;  

Discussion

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.

Availability

Introduced in Mac OS X v10.2

extern const CFStringRef kDRDeviceMediaBSDNameKey;  

Discussion

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.

Availability

Introduced in Mac OS X v10.2

extern const CFStringRef kDRDeviceMediaClassBD;  

Discussion

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

Availability

Introduced in Mac OS X v10.5.

extern const CFStringRef kDRDeviceMediaClassCD;  

Discussion

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

Availability

Introduced in Mac OS X v10.2

extern const CFStringRef kDRDeviceMediaClassDVD;  

Discussion

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

Availability

Introduced in Mac OS X v10.2

extern const CFStringRef kDRDeviceMediaClassHDDVD;  

Discussion

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

Availability

Introduced in Mac OS X v10.5.

extern const CFStringRef kDRDeviceMediaClassKey;  

Discussion

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.

Availability

Introduced in Mac OS X v10.2

extern const CFStringRef kDRDeviceMediaClassUnknown;  

Discussion

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

Availability

Introduced in Mac OS X v10.2

extern const CFStringRef kDRDeviceMediaDoubleLayerL0DataZoneBlocksKey;  

Discussion

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.

Availability

Introduced in Mac OS X v10.4.

extern const CFStringRef kDRDeviceMediaInfoKey;  

Discussion

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.

Availability

Introduced in Mac OS X v10.2

extern const CFStringRef kDRDeviceMediaIsAppendableKey;  

Discussion

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.

Availability

Introduced in Mac OS X v10.2

extern const CFStringRef kDRDeviceMediaIsBlankKey;  

Discussion

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.

Availability

Introduced in Mac OS X v10.2

extern const CFStringRef kDRDeviceMediaIsErasableKey;  

Discussion

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.

Availability

Introduced in Mac OS X v10.2

extern const CFStringRef kDRDeviceMediaIsOverwritableKey;  

Discussion

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.

Availability

Introduced in Mac OS X v10.3.

extern const CFStringRef kDRDeviceMediaIsReservedKey;  

Discussion

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.

Availability

Introduced in Mac OS X v10.2

extern const CFStringRef kDRDeviceMediaSessionCountKey;  

Discussion

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.

Availability

Introduced in Mac OS X v10.2

extern const CFStringRef kDRDeviceMediaStateInTransition;  

Discussion

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.

Availability

Introduced in Mac OS X v10.2

extern const CFStringRef kDRDeviceMediaStateKey;  

Discussion

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.

Availability

Introduced in Mac OS X v10.2

extern const CFStringRef kDRDeviceMediaStateMediaPresent;  

Discussion

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.

Availability

Introduced in Mac OS X v10.2

extern const CFStringRef kDRDeviceMediaStateNone;  

Discussion

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

Availability

Introduced in Mac OS X v10.2

extern const CFStringRef kDRDeviceMediaTrackCountKey;  

Discussion

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.

Availability

Introduced in Mac OS X v10.2

extern const CFStringRef kDRDeviceMediaTypeBDR;  

Discussion

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

Availability

Introduced in Mac OS X v10.5.

kDRDeviceMediaTypeBDRE

extern const CFStringRef kDRDeviceMediaTypeBDRE;  

Discussion

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

Availability

Introduced in Mac OS X v10.5.

kDRDeviceMediaTypeBDR

extern const CFStringRef kDRDeviceMediaTypeBDRE;  

Discussion

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

Availability

Introduced in Mac OS X v10.5.

extern const CFStringRef kDRDeviceMediaTypeBDROM;  

Discussion

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

Availability

Introduced in Mac OS X v10.5.

extern const CFStringRef kDRDeviceMediaTypeCDR;  

Discussion

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

Availability

Introduced in Mac OS X v10.2

extern const CFStringRef kDRDeviceMediaTypeCDROM;  

Discussion

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

Availability

Introduced in Mac OS X v10.2

extern const CFStringRef kDRDeviceMediaTypeCDRW;  

Discussion

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

Availability

Introduced in Mac OS X v10.2

extern const CFStringRef kDRDeviceMediaTypeDVDPlusR;  

Discussion

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

Availability

Introduced in Mac OS X v10.3.

extern const CFStringRef kDRDeviceMediaTypeDVDPlusRDoubleLayer;  

Discussion

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

Availability

Introduced in Mac OS X v10.4.

extern const CFStringRef kDRDeviceMediaTypeDVDPlusRW;  

Discussion

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

Availability

Introduced in Mac OS X v10.2

extern const CFStringRef kDRDeviceMediaTypeDVDPlusRWDoubleLayer;  

Discussion

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

Availability

Introduced in Mac OS X v10.5.

extern const CFStringRef kDRDeviceMediaTypeDVDR;  

Discussion

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

Availability

Introduced in Mac OS X v10.2

extern const CFStringRef kDRDeviceMediaTypeDVDRAM;  

Discussion

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

Availability

Introduced in Mac OS X v10.2

extern const CFStringRef kDRDeviceMediaTypeDVDRDualLayer;  

Discussion

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

Availability

Introduced in Mac OS X v10.5.

extern const CFStringRef kDRDeviceMediaTypeDVDROM;  

Discussion

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

Availability

Introduced in Mac OS X v10.2

extern const CFStringRef kDRDeviceMediaTypeDVDRW;  

Discussion

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

Availability

Introduced in Mac OS X v10.2

extern const CFStringRef kDRDeviceMediaTypeDVDRWDualLayer;  

Discussion

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

Availability

Introduced in Mac OS X v10.5.

extern const CFStringRef kDRDeviceMediaTypeHDDVDR;  

Discussion

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

Availability

Introduced in Mac OS X v10.5.

extern const CFStringRef kDRDeviceMediaTypeHDDVDRAM;  

Discussion

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

Availability

Introduced in Mac OS X v10.5.

extern const CFStringRef kDRDeviceMediaTypeHDDVDRDualLayer;  

Discussion

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

Availability

Introduced in Mac OS X v10.5.

extern const CFStringRef kDRDeviceMediaTypeHDDVDROM;  

Discussion

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

Availability

Introduced in Mac OS X v10.5.

extern const CFStringRef kDRDeviceMediaTypeHDDVDRW;  

Discussion

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

Availability

Introduced in Mac OS X v10.5.

extern const CFStringRef kDRDeviceMediaTypeHDDVDRWDualLayer;  

Discussion

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

Availability

Introduced in Mac OS X v10.5.

extern const CFStringRef kDRDeviceMediaTypeKey;  

Discussion

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.

Availability

Introduced in Mac OS X v10.2

extern const CFStringRef kDRDeviceMediaTypeUnknown;  

Discussion

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

Availability

Introduced in Mac OS X v10.2

extern const CFStringRef kDRDevicePhysicalInterconnectATAPI;  

Discussion

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

Availability

Introduced in Mac OS X v10.2

extern const CFStringRef kDRDevicePhysicalInterconnectFibreChannel;  

Discussion

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

Availability

Introduced in Mac OS X v10.3.

extern const CFStringRef kDRDevicePhysicalInterconnectFireWire;  

Discussion

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

Availability

Introduced in Mac OS X v10.2

extern const CFStringRef kDRDevicePhysicalInterconnectKey;  

Discussion

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.

Availability

Introduced in Mac OS X v10.2

extern const CFStringRef kDRDevicePhysicalInterconnectLocationExternal;  

Discussion

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

Availability

Introduced in Mac OS X v10.2

extern const CFStringRef kDRDevicePhysicalInterconnectLocationInternal;  

Discussion

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

Availability

Introduced in Mac OS X v10.2

extern const CFStringRef kDRDevicePhysicalInterconnectLocationKey;  

Discussion

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.

Availability

Introduced in Mac OS X v10.2

extern const CFStringRef kDRDevicePhysicalInterconnectLocationUnknown;  

Discussion

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.

Availability

Introduced in Mac OS X v10.2

extern const CFStringRef kDRDevicePhysicalInterconnectSCSI;  

Discussion

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

Availability

Introduced in Mac OS X v10.2

extern const CFStringRef kDRDevicePhysicalInterconnectUSB;  

Discussion

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

Availability

Introduced in Mac OS X v10.2

extern const CFStringRef kDRDeviceProductNameKey;  

Discussion

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.

Availability

Introduced in Mac OS X v10.2

extern const CFStringRef kDRDeviceStatusChangedNotification;  

Discussion

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 .

Availability

Introduced in Mac OS X v10.2

extern const CFStringRef kDRDeviceSupportLevelAppleShipping;  

Discussion

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.

Availability

Introduced in Mac OS X v10.2

extern const CFStringRef kDRDeviceSupportLevelAppleSupported;  

Discussion

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

Availability

Introduced in Mac OS X v10.2

extern const CFStringRef kDRDeviceSupportLevelKey;  

Discussion

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.

Availability

Introduced in Mac OS X v10.2

extern const CFStringRef kDRDeviceSupportLevelNone;  

Discussion

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

Availability

Introduced in Mac OS X v10.2

extern const CFStringRef kDRDeviceSupportLevelUnsupported;  

Discussion

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.

Availability

Introduced in Mac OS X v10.3.

extern const CFStringRef kDRDeviceSupportLevelVendorSupported;  

Discussion

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

Availability

Introduced in Mac OS X v10.2

extern const CFStringRef kDRDeviceTrackInfoKey;  

Discussion

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.

Availability

Introduced in Mac OS X v10.3.

extern const CFStringRef kDRDeviceTrackRefsKey;  

Discussion

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.

Availability

Introduced in Mac OS X v10.3.

extern const CFStringRef kDRDeviceVendorNameKey;  

Discussion

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.

Availability

Introduced in Mac OS X v10.2

extern const CFStringRef kDRDeviceWriteBufferSizeKey;  

Discussion

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.

Availability

Introduced in Mac OS X v10.3.

extern const CFStringRef kDRDeviceWriteCapabilitiesKey;  

Discussion

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.

Availability

Introduced in Mac OS X v10.2

Typedefs

typedef struct __DRDevice* DRDeviceRef;  

Discussion

This is the type of a reference to DRDevices.

#defines

#define DRDeviceCDXFactorForKPS(kps)  

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.

#define DRDeviceDVDXFactorForKPS(kps)  

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.

#define DRDeviceKPSForCDXFactor(xfactor)  

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.

#define DRDeviceKPSForDVDXFactor(xfactor)  

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.

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

Last Updated: 2008-04-01