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

 


DRStatus.h

Overview

Status dictionary content keys.



Constants


DRErrorStatusAdditionalSenseStringKey


extern NSString* const DRErrorStatusAdditionalSenseStringKey;  
Discussion

An NSString describing the RBC additional sense code and additional sense code qualifier pair returned by the device. If no sense is reported, this key will not be present.

Availability
Introduced in Mac OS X v10.2

DRErrorStatusErrorInfoStringKey


extern NSString* const DRErrorStatusErrorInfoStringKey;  
Discussion

An NSString describing extended error information in a user appropriate manner.

Availability
Introduced in Mac OS X v10.4.

DRErrorStatusErrorKey


extern NSString* const DRErrorStatusErrorKey;  
Discussion

An NSNumber containing the OS error code for the error.

Availability
Introduced in Mac OS X v10.2

DRErrorStatusErrorStringKey


extern NSString* const DRErrorStatusErrorStringKey;  
Discussion

An NSString describing the error in a user appropriate manner.

Availability
Introduced in Mac OS X v10.2

DRErrorStatusKey


extern NSString* const DRErrorStatusKey;  
Discussion

The key in the status dictionary for the error dictionary.

Availability
Introduced in Mac OS X v10.2

DRErrorStatusSenseCodeStringKey


extern NSString* const DRErrorStatusSenseCodeStringKey;  
Discussion

An NSString describing the RBC sense code returned by the device. If no sense is reported, this key will not be present.

Availability
Introduced in Mac OS X v10.2

DRErrorStatusSenseKey


extern NSString* const DRErrorStatusSenseKey;  
Discussion

An NSData object containing the raw RBC sense information structure reported by the device. If no sense is reported, this key will not be present.

Availability
Introduced in Mac OS X v10.2

DRStatusCurrentSessionKey


extern NSString* const DRStatusCurrentSessionKey;  
Discussion

A key for the burn status dictionary. NSNumber indicating the current session being burned.

Availability
Introduced in Mac OS X v10.2

DRStatusCurrentSpeedKey


extern NSString* const DRStatusCurrentSpeedKey;  
Discussion

A key for the burn status dictionary. NSNumber indicating the current burn speed.

Availability
Introduced in Mac OS X v10.2

DRStatusCurrentTrackKey


extern NSString* const DRStatusCurrentTrackKey;  
Discussion

A key for the status dictionaries. NSNumber indicating the current track being burned.

Availability
Introduced in Mac OS X v10.2

DRStatusEraseTypeKey


extern NSString* const DRStatusEraseTypeKey;  
Discussion

A key for the erase status dictionary. NSString indicating the type of erase operation.

Availability
Introduced in Mac OS X v10.2

DRStatusPercentCompleteKey


extern NSString* const DRStatusPercentCompleteKey;  
Discussion

A key for the status dictionaries. NSNumber containing the precent complete of the operation expressed as a foating point number from 0 to 1.

Availability
Introduced in Mac OS X v10.2

DRStatusProgressCurrentKPS


The current burn speed in kilobytes per second.

extern NSString* const DRStatusProgressCurrentKPS;  
Discussion

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

Availability
Introduced in Mac OS X v10.4.

DRStatusProgressCurrentXFactor


The current burn speed in a media appropriate x-factor

extern NSString* const DRStatusProgressCurrentXFactor;  
Discussion

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

Availability
Introduced in Mac OS X v10.4.

DRStatusProgressInfoKey


A dictionary of extended progress information.

extern NSString* const DRStatusProgressInfoKey;  
Discussion

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

Availability
Introduced in Mac OS X v10.4.

DRStatusStateDone


extern NSString* const DRStatusStateDone;  
Discussion

One possible value for DRStatusStateKey . Indicates the operation is finished and it succeeded.

Availability
Introduced in Mac OS X v10.2

DRStatusStateErasing


extern NSString* const DRStatusStateErasing;  
Discussion

One possible value for DRStatusStateKey in the erase status dictionary. Indicates the erase is currently in progress.

Availability
Introduced in Mac OS X v10.2

DRStatusStateFailed


extern NSString* const DRStatusStateFailed;  
Discussion

One possible value for DRStatusStateKey . Indicates the operation is finished and it failed.

Availability
Introduced in Mac OS X v10.2

DRStatusStateFinishing


extern NSString* const DRStatusStateFinishing;  
Discussion

One possible value for DRStatusStateKey in the burn status dictionary. Indicates the burn is finishing up (closing the last session, writing the TOC, etc).

Availability
Introduced in Mac OS X v10.2

DRStatusStateKey


extern NSString* const DRStatusStateKey;  
Discussion

A key for the status dictionaries. NSString indicating the current state of the operation.

Availability
Introduced in Mac OS X v10.2

DRStatusStateNone


extern NSString* const DRStatusStateNone;  
Discussion

One possible value for DRStatusStateKey . Indicates the operation has not yet begun.

Availability
Introduced in Mac OS X v10.2

DRStatusStatePreparing


extern NSString* const DRStatusStatePreparing;  
Discussion

One possible value for DRStatusStateKey . Indicates the operation is preparing to begin.

Availability
Introduced in Mac OS X v10.2

DRStatusStateSessionClose


extern NSString* const DRStatusStateSessionClose;  
Discussion

One possible value for DRStatusStateKey in the burn status dictionary. Indicates the burn is closing a session on disc. The exact session being closing is contained in DRStatusCurrentSessionKey .

Availability
Introduced in Mac OS X v10.2

DRStatusStateSessionOpen


extern NSString* const DRStatusStateSessionOpen;  
Discussion

One possible value for DRStatusStateKey in the burn status dictionary. Indicates the burn is opening a session on disc. The exact session being opened is contained in DRStatusCurrentSessionKey .

Availability
Introduced in Mac OS X v10.2

DRStatusStateTrackClose


extern NSString* const DRStatusStateTrackClose;  
Discussion

One possible value for DRStatusStateKey in the burn status dictionary. Indicates the burn is closing a track on disc. The exact track being closed is contained in DRStatusCurrentTrackKey .

Availability
Introduced in Mac OS X v10.2

DRStatusStateTrackOpen


extern NSString* const DRStatusStateTrackOpen;  
Discussion

One possible value for DRStatusStateKey in the burn status dictionary. Indicates the burn is opening a track on disc. The exact track being opened is contained in DRStatusCurrentTrackKey .

Availability
Introduced in Mac OS X v10.2

DRStatusStateTrackWrite


extern NSString* const DRStatusStateTrackWrite;  
Discussion

One possible value for DRStatusStateKey in the burn status dictionary. Indicates the burn is writing a track on disc. The exact track being written is contained in DRStatusCurrentTrackKey .

Availability
Introduced in Mac OS X v10.2

DRStatusStateVerifying


extern NSString* const DRStatusStateVerifying;  
Discussion

One possible value for DRStatusStateKey . Indicates the operation is verifying what it did.

Availability
Introduced in Mac OS X v10.2

DRStatusTotalSessionsKey


extern NSString* const DRStatusTotalSessionsKey;  
Discussion

A key for the status dictionaries. NSNumber indicating the total number of sessions being burned.

Availability
Introduced in Mac OS X v10.2

DRStatusTotalTracksKey


extern NSString* const DRStatusTotalTracksKey;  
Discussion

A key for the status dictionaries. NSNumber indicating the total number of tracks in the current session being burned.

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