rb_track_transfer_queue_new ()

RBTrackTransferQueue *
rb_track_transfer_queue_new (RBShell *shell);

Creates the RBTrackTransferQueue instance

rb_track_transfer_queue_start_batch ()

void
rb_track_transfer_queue_start_batch (RBTrackTransferQueue *queue,
                                     RBTrackTransferBatch *batch);

Adds a new transfer batch to the transfer queue; if the queue is currently empty, the transfer will start immediately, but not before the call returns.

rb_track_transfer_queue_cancel_batch ()

void
rb_track_transfer_queue_cancel_batch (RBTrackTransferQueue *queue,
                                      RBTrackTransferBatch *batch);

Removes a transfer batch from the queue. If an entry from the batch is currently being transferred, the transfer will be aborted.

rb_track_transfer_queue_find_batch_by_source ()

GList *
rb_track_transfer_queue_find_batch_by_source
                               (RBTrackTransferQueue *queue,
                                RBSource *source);

Finds all transfer batches where source is the source or destination. This should be used to wait for transfers to finish (or cancel them) before ejecting a device. The transfer batches are returned in the order they're found in the queue, so waiting for the RBTrackTransferBatch ::complete signal on the last one is sufficient to wait for them all to finish.

struct RBTrackTransferQueue

struct RBTrackTransferQueue;

struct RBTrackTransferQueueClass

struct RBTrackTransferQueueClass {
	GObjectClass parent_class;

	/* signals */
	void (*transfer_progress) (RBTrackTransferQueue *queue,
					 int done,
					 int total,
					 double fraction,
					 int time_left);
};

The “batch” property

  “batch”                    RBTrackTransferBatch *

The current RBTrackTransferBatch being processed

Flags: Read

The “shell” property

  “shell”                    RBShell *

The RBShell

Flags: Read / Write / Construct Only

The “missing-plugins” signal

gboolean
user_function (RBTrackTransferQueue *queue,
               GStrv                 details,
               GStrv                 descriptions,
               GClosure             *closure,
               gpointer              user_data)

Emitted to request installation of one or more encoder plugins for a destination media format. When the closure included in the signal args is called, the transfer batch will be started.

Flags: Run Last

The “transfer-progress” signal

void
user_function (RBTrackTransferQueue *queue,
               gint                  done,
               gint                  total,
               gdouble               fraction,
               gint                  time_left,
               gpointer              user_data)

Emitted regularly to convey progress information. At the end of any given transfer batch, there will be one signal emission with done == total and fraction == 1.0.

Flags: Run Last