BraseroSessionSpan

BraseroSessionSpan

Synopsis

                    BraseroSessionSpan;
BraseroSessionSpan * brasero_session_span_new           (void);
BraseroBurnResult   brasero_session_span_again          (BraseroSessionSpan *session);
BraseroBurnResult   brasero_session_span_possible       (BraseroSessionSpan *session);
BraseroBurnResult   brasero_session_span_start          (BraseroSessionSpan *session);
BraseroBurnResult   brasero_session_span_next           (BraseroSessionSpan *session);
void                brasero_session_span_stop           (BraseroSessionSpan *session);

Description

Details

BraseroSessionSpan

typedef struct _BraseroSessionSpan BraseroSessionSpan;


brasero_session_span_new ()

BraseroSessionSpan * brasero_session_span_new           (void);

Creates a new BraseroSessionSpan object.

Returns :

a BraseroSessionSpan object

brasero_session_span_again ()

BraseroBurnResult   brasero_session_span_again          (BraseroSessionSpan *session);

Checks whether some data were not included during calls to brasero_session_span_next().

session :

a BraseroSessionSpan

Returns :

a BraseroBurnResult. BRASERO_BURN_OK if there is not anymore data. BRASERO_BURN_RETRY if the operation was successful and a new BraseroTrackDataCfg was created. BRASERO_BURN_ERR otherwise.

brasero_session_span_possible ()

BraseroBurnResult   brasero_session_span_possible       (BraseroSessionSpan *session);

Checks if a new BraseroTrackData can be created from the files remaining in the tree after calls to brasero_session_span_next(). The maximum size of the data will be the one of the medium inserted in the BraseroDrive set for session (see brasero_burn_session_set_burner()).

session :

a BraseroSessionSpan

Returns :

a BraseroBurnResult. BRASERO_BURN_OK if there is not anymore data. BRASERO_BURN_RETRY if the operation was successful and a new BraseroTrackDataCfg was created. BRASERO_BURN_ERR otherwise.

brasero_session_span_start ()

BraseroBurnResult   brasero_session_span_start          (BraseroSessionSpan *session);

Get the object ready for spanning a BraseroBurnSession object. This function must be called before brasero_session_span_next().

session :

a BraseroSessionSpan

Returns :

a BraseroBurnResult. BRASERO_BURN_OK if successful.

brasero_session_span_next ()

BraseroBurnResult   brasero_session_span_next           (BraseroSessionSpan *session);

Sets the next batch of data to be burnt onto the medium inserted in the BraseroDrive set for session (see brasero_burn_session_set_burner()). Its free space or it capacity will be used as the maximum amount of data to be burnt.

session :

a BraseroSessionSpan

Returns :

a BraseroBurnResult. BRASERO_BURN_OK if successful.

brasero_session_span_stop ()

void                brasero_session_span_stop           (BraseroSessionSpan *session);

Ends and cleans a spanning operation started with brasero_session_span_start().

session :

a BraseroSessionSpan