Mac Dev Center Mac OS X Reference Library Drivers, Kernel, & Hardware: User-Space Device Access Disc Recording Framework Reference

Overview

Status dictionary content keys.

Constants

kDRStatusCurrentSessionKey

The number of the burn session.

kDRStatusCurrentSpeedKey

The current burn or erase speed.

kDRStatusCurrentTrackKey

The number of the track being burned.

kDRStatusEraseTypeKey

The type of erase operation.

kDRStatusPercentCompleteKey

The burn or erase operation's percentage of completion.

kDRStatusProgressCurrentKPS

The current burn speed in kilobytes per second.

kDRStatusProgressCurrentXFactor

The current burn speed in a media appropriate x-factor

kDRStatusProgressInfoKey

A dictionary of extended progress information.

kDRStatusStateDone

The burn or erase operation finished successfully.

kDRStatusStateErasing

The disc is being erased.

kDRStatusStateFailed

The burn or erase operation failed.

kDRStatusStateFinishing

The burn session is finishing.

kDRStatusStateKey

The state of the burn or erase operation.

kDRStatusStateNone

The burn or erase operation has not begun.

kDRStatusStatePreparing

The burn or erase operation is preparing to begin.

kDRStatusStateSessionClose

The burn session is closing.

kDRStatusStateSessionOpen

The burn session is opening.

kDRStatusStateTrackClose

The burn session is closing a track.

kDRStatusStateTrackOpen

The burn session is opening a track.

kDRStatusStateTrackWrite

The burn session is writing a track.

kDRStatusStateVerifying

The burn or erase operation is being verified.

kDRStatusTotalSessionsKey

The total number of burn sessions.

kDRStatusTotalTracksKey

The number of tracks in the current session.

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

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

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

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

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

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.

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.

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.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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