ADC Home > Reference Library > Reference > Audio > Carbon > Disc Recording Framework Reference

 


DRCoreStatus.h

Includes:
<CoreServices/CoreServices.h>
<AvailabilityMacros.h>

Overview

Status dictionary content keys.



Constants


kDRStatusCurrentSessionKey


The number of the burn session.

extern const CFStringRef kDRStatusCurrentSessionKey;  
Discussion

A key for the burn status dictionary. The value of this key is a CFNumber object containing the number of the current burn session.

Availability
Introduced in Mac OS X v10.2

kDRStatusCurrentSpeedKey


The current burn or erase speed.

extern const CFStringRef kDRStatusCurrentSpeedKey;  
Discussion

A key for the burn status dictionary. The value of this key is a CFNumber object containing the current burn or erase speed.

Availability
Introduced in Mac OS X v10.2

kDRStatusCurrentTrackKey


The number of the track being burned.

extern const CFStringRef kDRStatusCurrentTrackKey;  
Discussion

A key for the status dictionaries. The value of this key is a CFNumber object containing the number of the track being burned.

Availability
Introduced in Mac OS X v10.2

kDRStatusEraseTypeKey


The type of erase operation.

extern const CFStringRef kDRStatusEraseTypeKey;  
Discussion

A key for the erase status dictionary. The value of this key is a CFString object containing the type of erase operation -- either kDREraseTypeQuick or kDREraseTypeComplete .

Availability
Introduced in Mac OS X v10.2

kDRStatusPercentCompleteKey


The burn or erase operation's percentage of completion.

extern const CFStringRef kDRStatusPercentCompleteKey;  
Discussion

A key for the status dictionaries. The value of this key is a CFNumber object containing the precentage of completion for the burn or erase operation, expressed as a foating point number from 0 to 1.

Availability
Introduced in Mac OS X v10.2

kDRStatusProgressCurrentKPS


The current burn speed in kilobytes per second.

extern const CFStringRef kDRStatusProgressCurrentKPS;  
Discussion

This is an optional key within the kDRStatusProgressInfo dictionary. The value of this key, if present, is a CFNumber object containing the write speed of the burn.

Availability
Introduced in Mac OS X v10.4.

kDRStatusProgressCurrentXFactor


The current burn speed in a media appropriate x-factor

extern const CFStringRef kDRStatusProgressCurrentXFactor;  
Discussion

This is an optional key within the kDRStatusProgressInfo dictionary. The value of this key, if present, is a CFNumber object containing the appropriate x-factor for the media.

Availability
Introduced in Mac OS X v10.4.

kDRStatusProgressInfoKey


A dictionary of extended progress information.

extern const CFStringRef kDRStatusProgressInfoKey;  
Discussion

A key for the status dictionary. The value of this key is a reference to a CFDictionary object containing extended progress information.

Availability
Introduced in Mac OS X v10.4.

kDRStatusStateDone


The burn or erase operation finished successfully.

extern const CFStringRef kDRStatusStateDone;  
Discussion

A value for the kDRStatusStateKey dictionary key. This value indicates the burn or erase operation finished and succeeded.

Availability
Introduced in Mac OS X v10.2

kDRStatusStateErasing


The disc is being erased.

extern const CFStringRef kDRStatusStateErasing;  
Discussion

A value for the kDRStatusStateKey key in the erase status dictionary. This value indicates the erase is currently in progress.

Availability
Introduced in Mac OS X v10.2

kDRStatusStateFailed


The burn or erase operation failed.

extern const CFStringRef kDRStatusStateFailed;  
Discussion

A value for the kDRStatusStateKey dictionary key. This value indicates the burn or erase operation finished but failed.

Availability
Introduced in Mac OS X v10.2

kDRStatusStateFinishing


The burn session is finishing.

extern const CFStringRef kDRStatusStateFinishing;  
Discussion

A value for the kDRStatusStateKey key in the burn status dictionary. This value indicates the burn is finishing--closing the last session, writing the TOC, and so on.

Availability
Introduced in Mac OS X v10.2

kDRStatusStateKey


The state of the burn or erase operation.

extern const CFStringRef kDRStatusStateKey;  
Discussion

A key for the status dictionaries. The value of this key is a CFString object indicating the current state of the burn or erase operation.

Availability
Introduced in Mac OS X v10.2

kDRStatusStateNone


The burn or erase operation has not begun.

extern const CFStringRef kDRStatusStateNone;  
Discussion

A value for the kDRStatusStateKey dictionary key. This value indicates the burn or erase operation has not yet begun.

Availability
Introduced in Mac OS X v10.2

kDRStatusStatePreparing


The burn or erase operation is preparing to begin.

extern const CFStringRef kDRStatusStatePreparing;  
Discussion

A value for the kDRStatusStateKey dictionary key. This value indicates the burn or erase operation is preparing to begin.

Availability
Introduced in Mac OS X v10.2

kDRStatusStateSessionClose


The burn session is closing.

extern const CFStringRef kDRStatusStateSessionClose;  
Discussion

A value for the kDRStatusStateKey key in the burn status dictionary. This value indicates the burn engine is closing a session on disc. The number of the session being closed is available as the value for the kDRStatusCurrentSessionKey dictionary key.

Availability
Introduced in Mac OS X v10.2

kDRStatusStateSessionOpen


The burn session is opening.

extern const CFStringRef kDRStatusStateSessionOpen;  
Discussion

A value for the kDRStatusStateKey key in the burn status dictionary. This value indicates the burn engine is opening a session on disc. The number of the session being opened is available as the value for the kDRStatusCurrentSessionKey dictionary key.

Availability
Introduced in Mac OS X v10.2

kDRStatusStateTrackClose


The burn session is closing a track.

extern const CFStringRef kDRStatusStateTrackClose;  
Discussion

A value for the kDRStatusStateKey key in the burn status dictionary. This value indicates the burn engine is closing a track on disc. The number of the track being closed is available as the value for the kDRStatusCurrentTrackKey dictionary key.

Availability
Introduced in Mac OS X v10.2

kDRStatusStateTrackOpen


The burn session is opening a track.

extern const CFStringRef kDRStatusStateTrackOpen;  
Discussion

A value for the kDRStatusStateKey key in the burn status dictionary. This value indicates the burn engine is opening a track on disc. The number of the track being opened is available as the value for the kDRStatusCurrentTrackKey dictionary key.

Availability
Introduced in Mac OS X v10.2

kDRStatusStateTrackWrite


The burn session is writing a track.

extern const CFStringRef kDRStatusStateTrackWrite;  
Discussion

A value for the kDRStatusStateKey key in the burn status dictionary. This value indicates the burn engine is writing a track on disc. The number of the track being written is available as the value for the in kDRStatusCurrentTrackKey dictionary key.

Availability
Introduced in Mac OS X v10.2

kDRStatusStateVerifying


The burn or erase operation is being verified.

extern const CFStringRef kDRStatusStateVerifying;  
Discussion

A value for the kDRStatusStateKey dictionary key. This value indicates the operation is verifying what it did.

Availability
Introduced in Mac OS X v10.2

kDRStatusTotalSessionsKey


The total number of burn sessions.

extern const CFStringRef kDRStatusTotalSessionsKey;  
Discussion

A key for the status dictionaries. The value of this key is a CFNumber object containing the total number of sessions being burned.

Availability
Introduced in Mac OS X v10.2

kDRStatusTotalTracksKey


The number of tracks in the current session.

extern const CFStringRef kDRStatusTotalTracksKey;  
Discussion

A key for the status dictionaries. The value of this key is a CFNumber object containing the total number of tracks being burned in the current session.

Availability
Introduced in Mac OS X v10.2


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