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

Overview

This category on DRBurn defines methods that make setting and retrieving the various DRBurn properties easier.

Methods

-appendable

Indicates if the burn is appendable.

-completionAction

Returns the action to be performed at the end of the burn.

-requestedBurnSpeed

Returns the speed at which this burn will attempt to write data.

-setAppendable:

Sets the burn to be appendable or non-appendable.

-setCompletionAction:

Sets the action to be performed at the end of the burn.

-setRequestedBurnSpeed:

Sets the speed at which the burn will be attempted to be performed at

-setVerifyDisc:

Sets the burn to verify or not verify the disc.

-verifyDisc

Indicates if the resulting disc will be verified.

Indicates if the burn is appendable.

- (BOOL) appendable; 

Return Value

A BOOL indicating if the burn is appendable.

Discussion

When a burn completes, it can mark the disc so that no more data can be written to it. This creates a closed or non-appendable disc (which is the most compatible with audio CD players). If this method returns NO, then the disc will be marked as closed and no data can be appended to it. A return value of YES indicates further burns can be appended to the disc.

Returns the action to be performed at the end of the burn.

- (NSString*) completionAction; 

Return Value

An NSString

Returns the speed at which this burn will attempt to write data.

- (float) requestedBurnSpeed; 

Return Value

A float indicating the speed the burn should run at in kilobytes per second.

Discussion

The actual speed also depends on the capabilities of the bus the device is on, the maximum speed of the device itself, and the media used.

Sets the burn to be appendable or non-appendable.

- (void) setAppendable:(BOOL)appendable; 

Parameters

Discussion

When a burn completes, it can mark the disc so that no more data can be written to it. This creates a closed or non-appendable disc (which is the most compatible with audio CD players).

Sets the action to be performed at the end of the burn.

- (void) setCompletionAction:(NSString*)action; 

Parameters

Sets the speed at which the burn will be attempted to be performed at

- (void) setRequestedBurnSpeed:(float)speed; 

Parameters

Discussion

The actual speed also depends on the capabilities of the bus the device is on, the maximum speed of the device itself, and the media used.

Sets the burn to verify or not verify the disc.

- (void) setVerifyDisc:(BOOL)verify; 

Parameters

Indicates if the resulting disc will be verified.

- (BOOL) verifyDisc; 

Return Value

A BOOL indicating if the disc will be verified.

Discussion

After data is written to disc, the data can be verified. The verification process will read the data on the disc back into memory and compare it to the data originally used to write to disc. The type of verification is determined by a track property on a track-by-track basis. See the DRTrack documentation for more information on verification types.