## BraseroMediumMonitor

BraseroMediumMonitor

## Synopsis

                        BraseroMediumMonitor;
    BraseroMediumMonitor * brasero_medium_monitor_get_default
                                                            (void);
    enum                BraseroMediaType;
    enum                BraseroDriveType;
    GSList *            brasero_medium_monitor_get_media    (BraseroMediumMonitor *monitor,
                                                             BraseroMediaType type);
    GSList *            brasero_medium_monitor_get_drives   (BraseroMediumMonitor *monitor,
                                                             BraseroDriveType type);
    BraseroDrive *      brasero_medium_monitor_get_drive    (BraseroMediumMonitor *monitor,
                                                             const gchar *device);
    gboolean            brasero_medium_monitor_is_probing   (BraseroMediumMonitor *monitor);

## Description

## Details

### BraseroMediumMonitor

    typedef struct {
    	GObject parent_instance;
    } BraseroMediumMonitor;

### brasero_medium_monitor_get_default ()

    BraseroMediumMonitor * brasero_medium_monitor_get_default
                                                            (void);

Gets the currently active monitor.

Returns : | a BraseroMediumMonitor. Unref when it is not needed anymore.

### enum BraseroMediaType

    typedef enum {
    	BRASERO_MEDIA_TYPE_NONE				= 0,
    	BRASERO_MEDIA_TYPE_FILE				= 1,
    	BRASERO_MEDIA_TYPE_DATA				= 1 << 1,
    	BRASERO_MEDIA_TYPE_AUDIO			= 1 << 2,
    	BRASERO_MEDIA_TYPE_WRITABLE			= 1 << 3,
    	BRASERO_MEDIA_TYPE_REWRITABLE			= 1 << 4,
    	BRASERO_MEDIA_TYPE_ANY_IN_BURNER		= 1 << 5,

    	/* If combined with other flags it will filter.
    	 * if alone all CDs are returned.
    	 * It can't be combined with FILE type. */
    	BRASERO_MEDIA_TYPE_CD					= 1 << 6,

    	BRASERO_MEDIA_TYPE_ALL_BUT_FILE			= 0xFE,
    	BRASERO_MEDIA_TYPE_ALL				= 0xFF
    } BraseroMediaType;

### enum BraseroDriveType

    typedef enum {
    	BRASERO_DRIVE_TYPE_NONE				= 0,
    	BRASERO_DRIVE_TYPE_FILE				= 1,
    	BRASERO_DRIVE_TYPE_WRITER			= 1 << 1,
    	BRASERO_DRIVE_TYPE_READER			= 1 << 2,
    	BRASERO_DRIVE_TYPE_ALL_BUT_FILE			= 0xFE,
    	BRASERO_DRIVE_TYPE_ALL				= 0xFF
    } BraseroDriveType;

### brasero_medium_monitor_get_media ()

    GSList *            brasero_medium_monitor_get_media    (BraseroMediumMonitor *monitor,
                                                             BraseroMediaType type);

Obtains the list of available media that are of the given type.

`monitor` : | a BraseroMediumMonitor
`type` : | the type of BraseroMedium that should be in the list
Returns : | a GSList of BraseroMedium or NULL. The list must be freed and the element unreffed when finished. [element-type BraseroMedia.Medium][transfer full BraseroMedia.Medium]

### brasero_medium_monitor_get_drives ()

    GSList *            brasero_medium_monitor_get_drives   (BraseroMediumMonitor *monitor,
                                                             BraseroDriveType type);

Gets the list of available drives that are of the given type.

`monitor` : | a BraseroMediumMonitor
`type` : | a BraseroDriveType to tell what type of drives to include in the list
Returns : | a GSList of BraseroDrive or NULL. The list must be freed and the element unreffed when finished. [element-type BraseroMedia.Drive][transfer full BraseroMedia.Drive]

### brasero_medium_monitor_get_drive ()

    BraseroDrive *      brasero_medium_monitor_get_drive    (BraseroMediumMonitor *monitor,
                                                             const gchar *device);

Returns the BraseroDrive object whose path is `path`.

`monitor` : | a BraseroMediumMonitor
`device` : | the path of the device
Returns : | a BraseroDrive or NULL. It should be unreffed when no longer in use.

### brasero_medium_monitor_is_probing ()

    gboolean            brasero_medium_monitor_is_probing   (BraseroMediumMonitor *monitor);

Returns if the library is still probing some other media.

`monitor` : | a BraseroMediumMonitor
Returns : | `TRUE` if it is still probing some media