Mac Developer Library

Developer

DRCoreDevice.h Reference

Options
Deployment Target:

On This Page

DRCoreDevice.h Reference

Device interfaces for Disc Recording.

Included Headers

  • <CoreServices/CoreServices.h>

  • <DiscRecording/DRCoreObject.h>

  • <AvailabilityMacros.h>

  • <math.h>

  • <IOKit/IOKitLib.h>

Functions

  • Declaration

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

  • Declaration

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

  • Declaration

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

  • Declaration

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

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

    Declaration

    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.

  • Attempts to acquire an exclusive access session with the device.

    Declaration

    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.

  • Indicates an interest in reserving blank media.

    Declaration

    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.

  • Commands a device to close its tray.

    Declaration

    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.

  • Returns the device reference corresponding to the BSD device name.

    Declaration

    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.

  • Returns the device reference corresponding to the IORegistry entry.

    Declaration

    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.

  • Returns information about the device.

    Declaration

    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.

  • Returns the status of the device.

    Declaration

    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.

  • Commands a device to unmount and eject media.

    Declaration

    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 .

  • Returns the type identifier of all DRDevice instances.

    Declaration

    extern CFTypeID DRDeviceGetTypeID( void) AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER;

  • Determines whether the device is still attached and turned on.

    Declaration

    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.

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

    Declaration

    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.

  • Commands a device to open up its tray.

    Declaration

    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.

  • Release exclusive access to a device.

    Declaration

    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.

  • Rescind an interest in the blank media reservation.

    Declaration

    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.

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

    Declaration

    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.

Data Types

See the Overview for header-level documentation.

  • Declaration

    typedef struct __DRDevice* DRDeviceRef;

    Discussion

    This is the type of a reference to DRDevices.

    Import Statement

Constants

See the Overview for header-level documentation.

  • Declaration

    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.

    • kDRDeviceBurnSpeedBD1x

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

    • kDRDeviceBurnSpeedCD1x

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

    • kDRDeviceBurnSpeedDVD1x

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

    • kDRDeviceBurnSpeedHDDVD1x

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    • kDRDeviceMediaClassBD

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

    • kDRDeviceMediaClassCD

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

    • kDRDeviceMediaClassDVD

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

    • kDRDeviceMediaClassHDDVD

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

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

    • kDRDeviceMediaClassUnknown

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

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

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

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

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

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

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

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

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

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

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

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

    • kDRDeviceMediaStateNone

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

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

    • kDRDeviceMediaTypeBDR

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

    • kDRDeviceMediaTypeBDR

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

    • kDRDeviceMediaTypeBDRE

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

    • kDRDeviceMediaTypeBDROM

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

    • kDRDeviceMediaTypeCDR

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

    • kDRDeviceMediaTypeCDROM

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

    • kDRDeviceMediaTypeCDRW

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

    • kDRDeviceMediaTypeDVDPlusR

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

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

    • kDRDeviceMediaTypeDVDPlusRW

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

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

    • kDRDeviceMediaTypeDVDR

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

    • kDRDeviceMediaTypeDVDRAM

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

    • kDRDeviceMediaTypeDVDRDualLayer

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

    • kDRDeviceMediaTypeDVDROM

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

    • kDRDeviceMediaTypeDVDRW

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

    • kDRDeviceMediaTypeDVDRWDualLayer

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

    • kDRDeviceMediaTypeHDDVDR

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

    • kDRDeviceMediaTypeHDDVDRAM

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

    • kDRDeviceMediaTypeHDDVDRDualLayer

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

    • kDRDeviceMediaTypeHDDVDROM

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

    • kDRDeviceMediaTypeHDDVDRW

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

    • kDRDeviceMediaTypeHDDVDRWDualLayer

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

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

    • kDRDeviceMediaTypeUnknown

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

    • kDRDevicePhysicalInterconnectATAPI

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

    • kDRDevicePhysicalInterconnectFibreChannel

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

    • kDRDevicePhysicalInterconnectFireWire

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

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

    • kDRDevicePhysicalInterconnectLocationExternal

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

    • kDRDevicePhysicalInterconnectLocationInternal

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

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

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

    • kDRDevicePhysicalInterconnectSCSI

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

    • kDRDevicePhysicalInterconnectUSB

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

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

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

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

    • kDRDeviceSupportLevelAppleSupported

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

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

    • kDRDeviceSupportLevelNone

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

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

    • kDRDeviceSupportLevelVendorSupported

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

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

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

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

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

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