<refentry id="gnome-vfs-20-gnome-vfs-drive">
<refmeta>
<refentrytitle id="top_of_page">GnomeVFSDrive</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>GNOME-VFS-2.0 Library</refmiscinfo>
</refmeta>

<refnamediv>
<refname>GnomeVFSDrive</refname>
<refpurpose>Container for GnomeVFSVolume (floppy drive, CD reader, ...)</refpurpose>
<!--[<xref linkend="desc" endterm="desc.title"/>]-->
</refnamediv>

<refsynopsisdiv id="synopsis">
<title id="synopsis.title">Synopsis</title>
<anchor id="GnomeVFSDrive"/>
<synopsis>



enum        <link linkend="GnomeVFSDeviceType">GnomeVFSDeviceType</link>;
            <link linkend="GnomeVFSDrive-struct">GnomeVFSDrive</link>;
            <link linkend="GnomeVFSDriveClass">GnomeVFSDriveClass</link>;
#define     <link linkend="GNOME-IS-VFS-DRIVE:CAPS">GNOME_IS_VFS_DRIVE</link>              (o)
#define     <link linkend="GNOME-IS-VFS-DRIVE-CLASS:CAPS">GNOME_IS_VFS_DRIVE_CLASS</link>        (k)
#define     <link linkend="GNOME-VFS-TYPE-DRIVE:CAPS">GNOME_VFS_TYPE_DRIVE</link>
#define     <link linkend="GNOME-VFS-DRIVE:CAPS">GNOME_VFS_DRIVE</link>                 (o)
#define     <link linkend="GNOME-VFS-DRIVE-CLASS:CAPS">GNOME_VFS_DRIVE_CLASS</link>           (k)
<link linkend="gint">gint</link>        <link linkend="gnome-vfs-drive-compare">gnome_vfs_drive_compare</link>         (<link linkend="GnomeVFSDrive">GnomeVFSDrive</link> *a,
                                             <link linkend="GnomeVFSDrive">GnomeVFSDrive</link> *b);
<link linkend="void">void</link>        <link linkend="gnome-vfs-drive-eject">gnome_vfs_drive_eject</link>           (<link linkend="GnomeVFSDrive">GnomeVFSDrive</link> *drive,
                                             <link linkend="GnomeVFSVolumeOpCallback">GnomeVFSVolumeOpCallback</link> callback,
                                             <link linkend="gpointer">gpointer</link> user_data);
<link linkend="char">char</link>*       <link linkend="gnome-vfs-drive-get-activation-uri">gnome_vfs_drive_get_activation_uri</link>
                                            (<link linkend="GnomeVFSDrive">GnomeVFSDrive</link> *drive);
<link linkend="char">char</link>*       <link linkend="gnome-vfs-drive-get-device-path">gnome_vfs_drive_get_device_path</link> (<link linkend="GnomeVFSDrive">GnomeVFSDrive</link> *drive);
<link linkend="GnomeVFSDeviceType">GnomeVFSDeviceType</link> <link linkend="gnome-vfs-drive-get-device-type">gnome_vfs_drive_get_device_type</link>
                                            (<link linkend="GnomeVFSDrive">GnomeVFSDrive</link> *drive);
<link linkend="char">char</link>*       <link linkend="gnome-vfs-drive-get-display-name">gnome_vfs_drive_get_display_name</link>
                                            (<link linkend="GnomeVFSDrive">GnomeVFSDrive</link> *drive);
<link linkend="char">char</link>*       <link linkend="gnome-vfs-drive-get-hal-udi">gnome_vfs_drive_get_hal_udi</link>     (<link linkend="GnomeVFSDrive">GnomeVFSDrive</link> *drive);
<link linkend="char">char</link>*       <link linkend="gnome-vfs-drive-get-icon">gnome_vfs_drive_get_icon</link>        (<link linkend="GnomeVFSDrive">GnomeVFSDrive</link> *drive);
<link linkend="gulong">gulong</link>      <link linkend="gnome-vfs-drive-get-id">gnome_vfs_drive_get_id</link>          (<link linkend="GnomeVFSDrive">GnomeVFSDrive</link> *drive);
<link linkend="GnomeVFSVolume">GnomeVFSVolume</link>* <link linkend="gnome-vfs-drive-get-mounted-volume">gnome_vfs_drive_get_mounted_volume</link>
                                            (<link linkend="GnomeVFSDrive">GnomeVFSDrive</link> *drive);
<link linkend="GList">GList</link>*      <link linkend="gnome-vfs-drive-get-mounted-volumes">gnome_vfs_drive_get_mounted_volumes</link>
                                            (<link linkend="GnomeVFSDrive">GnomeVFSDrive</link> *drive);
<link linkend="void">void</link>        <link linkend="gnome-vfs-drive-volume-list-free">gnome_vfs_drive_volume_list_free</link>
                                            (<link linkend="GList">GList</link> *volumes);
<link linkend="GType">GType</link>       <link linkend="gnome-vfs-drive-get-type">gnome_vfs_drive_get_type</link>        (void);
<link linkend="gboolean">gboolean</link>    <link linkend="gnome-vfs-drive-is-connected">gnome_vfs_drive_is_connected</link>    (<link linkend="GnomeVFSDrive">GnomeVFSDrive</link> *drive);
<link linkend="gboolean">gboolean</link>    <link linkend="gnome-vfs-drive-is-mounted">gnome_vfs_drive_is_mounted</link>      (<link linkend="GnomeVFSDrive">GnomeVFSDrive</link> *drive);
<link linkend="gboolean">gboolean</link>    <link linkend="gnome-vfs-drive-is-user-visible">gnome_vfs_drive_is_user_visible</link> (<link linkend="GnomeVFSDrive">GnomeVFSDrive</link> *drive);
<link linkend="void">void</link>        <link linkend="gnome-vfs-drive-mount">gnome_vfs_drive_mount</link>           (<link linkend="GnomeVFSDrive">GnomeVFSDrive</link> *drive,
                                             <link linkend="GnomeVFSVolumeOpCallback">GnomeVFSVolumeOpCallback</link> callback,
                                             <link linkend="gpointer">gpointer</link> user_data);
<link linkend="GnomeVFSDrive">GnomeVFSDrive</link>* <link linkend="gnome-vfs-drive-ref">gnome_vfs_drive_ref</link>          (<link linkend="GnomeVFSDrive">GnomeVFSDrive</link> *drive);
<link linkend="void">void</link>        <link linkend="gnome-vfs-drive-unmount">gnome_vfs_drive_unmount</link>         (<link linkend="GnomeVFSDrive">GnomeVFSDrive</link> *drive,
                                             <link linkend="GnomeVFSVolumeOpCallback">GnomeVFSVolumeOpCallback</link> callback,
                                             <link linkend="gpointer">gpointer</link> user_data);
<link linkend="void">void</link>        <link linkend="gnome-vfs-drive-unref">gnome_vfs_drive_unref</link>           (<link linkend="GnomeVFSDrive">GnomeVFSDrive</link> *drive);
</synopsis>
</refsynopsisdiv>

<refsect1 id="object_hierarchy">
<title id="object_hierarchy.title">Object Hierarchy</title>
<synopsis>

  <link linkend="GObject">GObject</link>
   +----GnomeVFSDrive
</synopsis>

</refsect1>






<refsect1 id="signal_proto">
<title id="signal_proto.title">Signals</title>
<synopsis>

&quot;<link linkend="GnomeVFSDrive-volume-mounted">volume-mounted</link>&quot;
            <link linkend="void">void</link>        user_function      (<link linkend="GnomeVFSDrive">GnomeVFSDrive</link>  *vfsdrive,
                                            <link linkend="GnomeVFSVolume">GnomeVFSVolume</link> *arg1,
                                            <link linkend="gpointer">gpointer</link>        user_data)      : Run first
&quot;<link linkend="GnomeVFSDrive-volume-pre-unmount">volume-pre-unmount</link>&quot;
            <link linkend="void">void</link>        user_function      (<link linkend="GnomeVFSDrive">GnomeVFSDrive</link>  *vfsdrive,
                                            <link linkend="GnomeVFSVolume">GnomeVFSVolume</link> *arg1,
                                            <link linkend="gpointer">gpointer</link>        user_data)      : Run first
&quot;<link linkend="GnomeVFSDrive-volume-unmounted">volume-unmounted</link>&quot;
            <link linkend="void">void</link>        user_function      (<link linkend="GnomeVFSDrive">GnomeVFSDrive</link>  *vfsdrive,
                                            <link linkend="GnomeVFSVolume">GnomeVFSVolume</link> *arg1,
                                            <link linkend="gpointer">gpointer</link>        user_data)      : Run first
</synopsis>
</refsect1>


<refsect1 id="desc">
<title id="desc.title">Description</title>
<para>

</para>
</refsect1>

<refsect1 id="details">
<title id="details.title">Details</title>
<refsect2>
<title><anchor id="GnomeVFSDeviceType" role="enum"/>enum GnomeVFSDeviceType</title>
<indexterm><primary>GnomeVFSDeviceType</primary></indexterm><programlisting>typedef enum {
	GNOME_VFS_DEVICE_TYPE_UNKNOWN,
	GNOME_VFS_DEVICE_TYPE_AUDIO_CD,
	GNOME_VFS_DEVICE_TYPE_VIDEO_DVD,
	GNOME_VFS_DEVICE_TYPE_HARDDRIVE, 
	GNOME_VFS_DEVICE_TYPE_CDROM,
	GNOME_VFS_DEVICE_TYPE_FLOPPY,
	GNOME_VFS_DEVICE_TYPE_ZIP,
	GNOME_VFS_DEVICE_TYPE_JAZ,
	GNOME_VFS_DEVICE_TYPE_NFS,
	GNOME_VFS_DEVICE_TYPE_AUTOFS,
	GNOME_VFS_DEVICE_TYPE_CAMERA,
	GNOME_VFS_DEVICE_TYPE_MEMORY_STICK,
	GNOME_VFS_DEVICE_TYPE_SMB,
	GNOME_VFS_DEVICE_TYPE_APPLE,
	GNOME_VFS_DEVICE_TYPE_MUSIC_PLAYER,
	GNOME_VFS_DEVICE_TYPE_WINDOWS, 
	GNOME_VFS_DEVICE_TYPE_LOOPBACK, 
	GNOME_VFS_DEVICE_TYPE_NETWORK 
} GnomeVFSDeviceType;
</programlisting>
<para>

</para></refsect2>
<refsect2>
<title><anchor id="GnomeVFSDrive-struct" role="struct"/>GnomeVFSDrive</title>
<indexterm><primary>GnomeVFSDrive</primary></indexterm><programlisting>typedef struct _GnomeVFSDrive GnomeVFSDrive;</programlisting>
<para>

</para></refsect2>
<refsect2>
<title><anchor id="GnomeVFSDriveClass" role="struct"/>GnomeVFSDriveClass</title>
<indexterm><primary>GnomeVFSDriveClass</primary></indexterm><programlisting>typedef struct {
	GObjectClass parent_class;

	void (* volume_mounted)	  	(GnomeVFSDrive *drive,
				   	 GnomeVFSVolume	*volume);
	void (* volume_pre_unmount)	(GnomeVFSDrive *drive,
				   	 GnomeVFSVolume	*volume);
	void (* volume_unmounted)	(GnomeVFSDrive *drive,
				   	 GnomeVFSVolume	*volume);
} GnomeVFSDriveClass;
</programlisting>
<para>

</para></refsect2>
<refsect2>
<title><anchor id="GNOME-IS-VFS-DRIVE:CAPS" role="macro"/>GNOME_IS_VFS_DRIVE()</title>
<indexterm><primary>GNOME_IS_VFS_DRIVE</primary></indexterm><programlisting>#define GNOME_IS_VFS_DRIVE(o)       (G_TYPE_CHECK_INSTANCE_TYPE ((o), GNOME_VFS_TYPE_DRIVE))
</programlisting>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>o</parameter>&nbsp;:</term>
<listitem><simpara>


</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="GNOME-IS-VFS-DRIVE-CLASS:CAPS" role="macro"/>GNOME_IS_VFS_DRIVE_CLASS()</title>
<indexterm><primary>GNOME_IS_VFS_DRIVE_CLASS</primary></indexterm><programlisting>#define GNOME_IS_VFS_DRIVE_CLASS(k) (G_TYPE_CHECK_CLASS_TYPE ((k), GNOME_VFS_TYPE_DRIVE))
</programlisting>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>k</parameter>&nbsp;:</term>
<listitem><simpara>


</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="GNOME-VFS-TYPE-DRIVE:CAPS" role="macro"/>GNOME_VFS_TYPE_DRIVE</title>
<indexterm><primary>GNOME_VFS_TYPE_DRIVE</primary></indexterm><programlisting>#define GNOME_VFS_TYPE_DRIVE        (gnome_vfs_drive_get_type ())
</programlisting>
<para>

</para></refsect2>
<refsect2>
<title><anchor id="GNOME-VFS-DRIVE:CAPS" role="macro"/>GNOME_VFS_DRIVE()</title>
<indexterm><primary>GNOME_VFS_DRIVE</primary></indexterm><programlisting>#define GNOME_VFS_DRIVE(o)          (G_TYPE_CHECK_INSTANCE_CAST ((o), GNOME_VFS_TYPE_DRIVE, GnomeVFSDrive))
</programlisting>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>o</parameter>&nbsp;:</term>
<listitem><simpara>


</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="GNOME-VFS-DRIVE-CLASS:CAPS" role="macro"/>GNOME_VFS_DRIVE_CLASS()</title>
<indexterm><primary>GNOME_VFS_DRIVE_CLASS</primary></indexterm><programlisting>#define GNOME_VFS_DRIVE_CLASS(k)    (G_TYPE_CHECK_CLASS_CAST((k), GNOME_VFS_TYPE_DRIVE, GnomeVFSDriveClass))
</programlisting>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>k</parameter>&nbsp;:</term>
<listitem><simpara>


</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gnome-vfs-drive-compare" role="function" condition="since:2.6"/>gnome_vfs_drive_compare ()</title>
<indexterm role="2.6"><primary>gnome_vfs_drive_compare</primary></indexterm><programlisting><link linkend="gint">gint</link>        gnome_vfs_drive_compare         (<link linkend="GnomeVFSDrive">GnomeVFSDrive</link> *a,
                                             <link linkend="GnomeVFSDrive">GnomeVFSDrive</link> *b);</programlisting>
<para>
</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>a</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GnomeVFSDrive"><type>GnomeVFSDrive</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>b</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GnomeVFSDrive"><type>GnomeVFSDrive</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> 0 if the drives are same.

</simpara></listitem></varlistentry>
</variablelist><para>Since  2.6
</para></refsect2>
<refsect2>
<title><anchor id="gnome-vfs-drive-eject" role="function" condition="since:2.6"/>gnome_vfs_drive_eject ()</title>
<indexterm role="2.6"><primary>gnome_vfs_drive_eject</primary></indexterm><programlisting><link linkend="void">void</link>        gnome_vfs_drive_eject           (<link linkend="GnomeVFSDrive">GnomeVFSDrive</link> *drive,
                                             <link linkend="GnomeVFSVolumeOpCallback">GnomeVFSVolumeOpCallback</link> callback,
                                             <link linkend="gpointer">gpointer</link> user_data);</programlisting>
<para>
</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>drive</parameter>&nbsp;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>callback</parameter>&nbsp;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&nbsp;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist><para>Since  2.6
</para></refsect2>
<refsect2>
<title><anchor id="gnome-vfs-drive-get-activation-uri" role="function" condition="since:2.6"/>gnome_vfs_drive_get_activation_uri ()</title>
<indexterm role="2.6"><primary>gnome_vfs_drive_get_activation_uri</primary></indexterm><programlisting><link linkend="char">char</link>*       gnome_vfs_drive_get_activation_uri
                                            (<link linkend="GnomeVFSDrive">GnomeVFSDrive</link> *drive);</programlisting>
<para>
</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>drive</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GnomeVFSDrive"><type>GnomeVFSDrive</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> a newly allocated string for the activation uri of the <link linkend="drive"><type>drive</type></link>.

</simpara></listitem></varlistentry>
</variablelist><para>Since  2.6
</para></refsect2>
<refsect2>
<title><anchor id="gnome-vfs-drive-get-device-path" role="function" condition="since:2.6"/>gnome_vfs_drive_get_device_path ()</title>
<indexterm role="2.6"><primary>gnome_vfs_drive_get_device_path</primary></indexterm><programlisting><link linkend="char">char</link>*       gnome_vfs_drive_get_device_path (<link linkend="GnomeVFSDrive">GnomeVFSDrive</link> *drive);</programlisting>
<para>
</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>drive</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GnomeVFSDrive"><type>GnomeVFSDrive</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> a newly allocated string for the device path of the <link linkend="drive"><type>drive</type></link>.

</simpara></listitem></varlistentry>
</variablelist><para>Since  2.6
</para></refsect2>
<refsect2>
<title><anchor id="gnome-vfs-drive-get-device-type" role="function" condition="since:2.6"/>gnome_vfs_drive_get_device_type ()</title>
<indexterm role="2.6"><primary>gnome_vfs_drive_get_device_type</primary></indexterm><programlisting><link linkend="GnomeVFSDeviceType">GnomeVFSDeviceType</link> gnome_vfs_drive_get_device_type
                                            (<link linkend="GnomeVFSDrive">GnomeVFSDrive</link> *drive);</programlisting>
<para>
</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>drive</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GnomeVFSDrive"><type>GnomeVFSDrive</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> device type, a <link linkend="GnomeVFSDeviceType"><type>GnomeVFSDeviceType</type></link> value.

</simpara></listitem></varlistentry>
</variablelist><para>Since  2.6
</para></refsect2>
<refsect2>
<title><anchor id="gnome-vfs-drive-get-display-name" role="function" condition="since:2.6"/>gnome_vfs_drive_get_display_name ()</title>
<indexterm role="2.6"><primary>gnome_vfs_drive_get_display_name</primary></indexterm><programlisting><link linkend="char">char</link>*       gnome_vfs_drive_get_display_name
                                            (<link linkend="GnomeVFSDrive">GnomeVFSDrive</link> *drive);</programlisting>
<para>
</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>drive</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GnomeVFSDrive"><type>GnomeVFSDrive</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> a newly allocated string for the display name of the <parameter>drive</parameter>.

</simpara></listitem></varlistentry>
</variablelist><para>Since  2.6
</para></refsect2>
<refsect2>
<title><anchor id="gnome-vfs-drive-get-hal-udi" role="function" condition="since:2.6"/>gnome_vfs_drive_get_hal_udi ()</title>
<indexterm role="2.6"><primary>gnome_vfs_drive_get_hal_udi</primary></indexterm><programlisting><link linkend="char">char</link>*       gnome_vfs_drive_get_hal_udi     (<link linkend="GnomeVFSDrive">GnomeVFSDrive</link> *drive);</programlisting>
<para>
</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>drive</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GnomeVFSDrive"><type>GnomeVFSDrive</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> a newly allocated string for the unique device id of the <parameter>drive</parameter>.

</simpara></listitem></varlistentry>
</variablelist><para>Since  2.6
</para></refsect2>
<refsect2>
<title><anchor id="gnome-vfs-drive-get-icon" role="function" condition="since:2.6"/>gnome_vfs_drive_get_icon ()</title>
<indexterm role="2.6"><primary>gnome_vfs_drive_get_icon</primary></indexterm><programlisting><link linkend="char">char</link>*       gnome_vfs_drive_get_icon        (<link linkend="GnomeVFSDrive">GnomeVFSDrive</link> *drive);</programlisting>
<para>
</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>drive</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GnomeVFSDrive"><type>GnomeVFSDrive</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> a newly allocated string for the icon filename of the <parameter>drive</parameter>.

</simpara></listitem></varlistentry>
</variablelist><para>Since  2.6
</para></refsect2>
<refsect2>
<title><anchor id="gnome-vfs-drive-get-id" role="function" condition="since:2.6"/>gnome_vfs_drive_get_id ()</title>
<indexterm role="2.6"><primary>gnome_vfs_drive_get_id</primary></indexterm><programlisting><link linkend="gulong">gulong</link>      gnome_vfs_drive_get_id          (<link linkend="GnomeVFSDrive">GnomeVFSDrive</link> *drive);</programlisting>
<para>
</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>drive</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GnomeVFSDrive"><type>GnomeVFSDrive</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> drive id, a <link linkend="gulong"><type>gulong</type></link> value.

</simpara></listitem></varlistentry>
</variablelist><para>Since  2.6
</para></refsect2>
<refsect2>
<title><anchor id="gnome-vfs-drive-get-mounted-volume" role="function" condition="deprecated:Use gnome_vfs_drive_get_mounted_volumes() instead.|since:2.6"/>gnome_vfs_drive_get_mounted_volume ()</title>
<indexterm role="deprecated 2.6"><primary>gnome_vfs_drive_get_mounted_volume</primary></indexterm><programlisting><link linkend="GnomeVFSVolume">GnomeVFSVolume</link>* gnome_vfs_drive_get_mounted_volume
                                            (<link linkend="GnomeVFSDrive">GnomeVFSDrive</link> *drive);</programlisting>
<warning><para><literal>gnome_vfs_drive_get_mounted_volume</literal> is deprecated and should not be used in newly-written code. Use <link linkend="gnome-vfs-drive-get-mounted-volumes"><function>gnome_vfs_drive_get_mounted_volumes()</function></link> instead.</para></warning>
<para>
Returns the first mounted volume for the <parameter>drive</parameter>.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>drive</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GnomeVFSDrive"><type>GnomeVFSDrive</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> a <link linkend="GnomeVFSVolume"><type>GnomeVFSVolume</type></link>.

</simpara></listitem></varlistentry>
</variablelist><para>Since  2.6
</para></refsect2>
<refsect2>
<title><anchor id="gnome-vfs-drive-get-mounted-volumes" role="function" condition="since:2.8"/>gnome_vfs_drive_get_mounted_volumes ()</title>
<indexterm role="2.8"><primary>gnome_vfs_drive_get_mounted_volumes</primary></indexterm><programlisting><link linkend="GList">GList</link>*      gnome_vfs_drive_get_mounted_volumes
                                            (<link linkend="GnomeVFSDrive">GnomeVFSDrive</link> *drive);</programlisting>
<para>
</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>drive</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GnomeVFSDrive"><type>GnomeVFSDrive</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> list of mounted volumes for the <parameter>drive</parameter>.

</simpara></listitem></varlistentry>
</variablelist><para>Since  2.8
</para></refsect2>
<refsect2>
<title><anchor id="gnome-vfs-drive-volume-list-free" role="function" condition="since:2.8"/>gnome_vfs_drive_volume_list_free ()</title>
<indexterm role="2.8"><primary>gnome_vfs_drive_volume_list_free</primary></indexterm><programlisting><link linkend="void">void</link>        gnome_vfs_drive_volume_list_free
                                            (<link linkend="GList">GList</link> *volumes);</programlisting>
<para>
Frees the list <parameter>volumes</parameter>.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>volumes</parameter>&nbsp;:</term>
<listitem><simpara> list of <link linkend="GnomeVFSVolumes"><type>GnomeVFSVolumes</type></link> to be freed.
</simpara></listitem></varlistentry>
</variablelist><para>Since  2.8
</para></refsect2>
<refsect2>
<title><anchor id="gnome-vfs-drive-get-type" role="function"/>gnome_vfs_drive_get_type ()</title>
<indexterm><primary>gnome_vfs_drive_get_type</primary></indexterm><programlisting><link linkend="GType">GType</link>       gnome_vfs_drive_get_type        (void);</programlisting>
<para>

</para><variablelist role="params">
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara>


</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gnome-vfs-drive-is-connected" role="function" condition="since:2.6"/>gnome_vfs_drive_is_connected ()</title>
<indexterm role="2.6"><primary>gnome_vfs_drive_is_connected</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>    gnome_vfs_drive_is_connected    (<link linkend="GnomeVFSDrive">GnomeVFSDrive</link> *drive);</programlisting>
<para>
</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>drive</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GnomeVFSDrive"><type>GnomeVFSDrive</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> <literal>TRUE</literal> if the <parameter>drive</parameter> is connected, <literal>FALSE</literal> otherwise.

</simpara></listitem></varlistentry>
</variablelist><para>Since  2.6
</para></refsect2>
<refsect2>
<title><anchor id="gnome-vfs-drive-is-mounted" role="function" condition="since:2.6"/>gnome_vfs_drive_is_mounted ()</title>
<indexterm role="2.6"><primary>gnome_vfs_drive_is_mounted</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>    gnome_vfs_drive_is_mounted      (<link linkend="GnomeVFSDrive">GnomeVFSDrive</link> *drive);</programlisting>
<para>
</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>drive</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GnomeVFSDrive"><type>GnomeVFSDrive</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> <literal>TRUE</literal> if the <parameter>drive</parameter> is mounted, <literal>FALSE</literal> otherwise.

</simpara></listitem></varlistentry>
</variablelist><para>Since  2.6
</para></refsect2>
<refsect2>
<title><anchor id="gnome-vfs-drive-is-user-visible" role="function" condition="since:2.6"/>gnome_vfs_drive_is_user_visible ()</title>
<indexterm role="2.6"><primary>gnome_vfs_drive_is_user_visible</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>    gnome_vfs_drive_is_user_visible (<link linkend="GnomeVFSDrive">GnomeVFSDrive</link> *drive);</programlisting>
<para>
</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>drive</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GnomeVFSDrive"><type>GnomeVFSDrive</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> <literal>TRUE</literal> if the <parameter>drive</parameter> is visible to the user, <literal>FALSE</literal> otherwise.

</simpara></listitem></varlistentry>
</variablelist><para>Since  2.6
</para></refsect2>
<refsect2>
<title><anchor id="gnome-vfs-drive-mount" role="function" condition="since:2.6"/>gnome_vfs_drive_mount ()</title>
<indexterm role="2.6"><primary>gnome_vfs_drive_mount</primary></indexterm><programlisting><link linkend="void">void</link>        gnome_vfs_drive_mount           (<link linkend="GnomeVFSDrive">GnomeVFSDrive</link> *drive,
                                             <link linkend="GnomeVFSVolumeOpCallback">GnomeVFSVolumeOpCallback</link> callback,
                                             <link linkend="gpointer">gpointer</link> user_data);</programlisting>
<para>
</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>drive</parameter>&nbsp;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>callback</parameter>&nbsp;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&nbsp;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist><para>Since  2.6
</para></refsect2>
<refsect2>
<title><anchor id="gnome-vfs-drive-ref" role="function" condition="since:2.6"/>gnome_vfs_drive_ref ()</title>
<indexterm role="2.6"><primary>gnome_vfs_drive_ref</primary></indexterm><programlisting><link linkend="GnomeVFSDrive">GnomeVFSDrive</link>* gnome_vfs_drive_ref          (<link linkend="GnomeVFSDrive">GnomeVFSDrive</link> *drive);</programlisting>
<para>
Increases the refcount of the <parameter>drive</parameter> by 1.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>drive</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GnomeVFSDrive"><type>GnomeVFSDrive</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> the <parameter>drive</parameter>.

</simpara></listitem></varlistentry>
</variablelist><para>Since  2.6
</para></refsect2>
<refsect2>
<title><anchor id="gnome-vfs-drive-unmount" role="function" condition="since:2.6"/>gnome_vfs_drive_unmount ()</title>
<indexterm role="2.6"><primary>gnome_vfs_drive_unmount</primary></indexterm><programlisting><link linkend="void">void</link>        gnome_vfs_drive_unmount         (<link linkend="GnomeVFSDrive">GnomeVFSDrive</link> *drive,
                                             <link linkend="GnomeVFSVolumeOpCallback">GnomeVFSVolumeOpCallback</link> callback,
                                             <link linkend="gpointer">gpointer</link> user_data);</programlisting>
<para>
</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>drive</parameter>&nbsp;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>callback</parameter>&nbsp;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&nbsp;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist><para>Since  2.6
</para></refsect2>
<refsect2>
<title><anchor id="gnome-vfs-drive-unref" role="function" condition="since:2.6"/>gnome_vfs_drive_unref ()</title>
<indexterm role="2.6"><primary>gnome_vfs_drive_unref</primary></indexterm><programlisting><link linkend="void">void</link>        gnome_vfs_drive_unref           (<link linkend="GnomeVFSDrive">GnomeVFSDrive</link> *drive);</programlisting>
<para>
Decreases the refcount of the <parameter>drive</parameter> by 1.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>drive</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GnomeVFSDrive"><type>GnomeVFSDrive</type></link>.
</simpara></listitem></varlistentry>
</variablelist><para>Since  2.6
</para></refsect2>

</refsect1>

<refsect1 id="signals">
<title id="signals.title">Signal Details</title>
<refsect2><title><anchor id="GnomeVFSDrive-volume-mounted"/>The &quot;volume-mounted&quot; signal</title>
<programlisting><link linkend="void">void</link>        user_function                  (<link linkend="GnomeVFSDrive">GnomeVFSDrive</link>  *vfsdrive,
                                            <link linkend="GnomeVFSVolume">GnomeVFSVolume</link> *arg1,
                                            <link linkend="gpointer">gpointer</link>        user_data)      : Run first</programlisting>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>vfsdrive</parameter>&nbsp;:</term>
<listitem><simpara>the object which received the signal.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>arg1</parameter>&nbsp;:</term>
<listitem><simpara>

</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&nbsp;:</term>
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
</variablelist></refsect2><refsect2><title><anchor id="GnomeVFSDrive-volume-pre-unmount"/>The &quot;volume-pre-unmount&quot; signal</title>
<programlisting><link linkend="void">void</link>        user_function                  (<link linkend="GnomeVFSDrive">GnomeVFSDrive</link>  *vfsdrive,
                                            <link linkend="GnomeVFSVolume">GnomeVFSVolume</link> *arg1,
                                            <link linkend="gpointer">gpointer</link>        user_data)      : Run first</programlisting>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>vfsdrive</parameter>&nbsp;:</term>
<listitem><simpara>the object which received the signal.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>arg1</parameter>&nbsp;:</term>
<listitem><simpara>

</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&nbsp;:</term>
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
</variablelist></refsect2><refsect2><title><anchor id="GnomeVFSDrive-volume-unmounted"/>The &quot;volume-unmounted&quot; signal</title>
<programlisting><link linkend="void">void</link>        user_function                  (<link linkend="GnomeVFSDrive">GnomeVFSDrive</link>  *vfsdrive,
                                            <link linkend="GnomeVFSVolume">GnomeVFSVolume</link> *arg1,
                                            <link linkend="gpointer">gpointer</link>        user_data)      : Run first</programlisting>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>vfsdrive</parameter>&nbsp;:</term>
<listitem><simpara>the object which received the signal.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>arg1</parameter>&nbsp;:</term>
<listitem><simpara>

</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&nbsp;:</term>
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
</variablelist></refsect2>
</refsect1>



</refentry>
