docs/reference/gio/html/GDrive.html

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
   2 <html>
   3 <head>
   4 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
   5 <title>GDrive: GIO Reference Manual</title>
   6 <meta name="generator" content="DocBook XSL Stylesheets V1.79.1">
   7 <link rel="home" href="index.html" title="GIO Reference Manual">
   8 <link rel="up" href="volume_mon.html" title="Volumes and Drives">
   9 <link rel="prev" href="GMount.html" title="GMount">
  10 <link rel="next" href="gio-Unix-Mounts.html" title="Unix Mounts">
  11 <meta name="generator" content="GTK-Doc V1.25.1 (XML mode)">
  12 <link rel="stylesheet" href="style.css" type="text/css">
  13 </head>
  14 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
  15 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
  16 <td width="100%" align="left" class="shortcuts">
  17 <a href="#" class="shortcut">Top</a><span id="nav_description">  <span class="dim">|</span>
  18                   <a href="#GDrive.description" class="shortcut">Description</a></span><span id="nav_hierarchy">  <span class="dim">|</span>
  19                   <a href="#GDrive.object-hierarchy" class="shortcut">Object Hierarchy</a></span><span id="nav_prerequisites">  <span class="dim">|</span>
  20                   <a href="#GDrive.prerequisites" class="shortcut">Prerequisites</a></span><span id="nav_signals">  <span class="dim">|</span>
  21                   <a href="#GDrive.signals" class="shortcut">Signals</a></span>
  22 </td>
  23 <td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
  24 <td><a accesskey="u" href="volume_mon.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
  25 <td><a accesskey="p" href="GMount.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
  26 <td><a accesskey="n" href="gio-Unix-Mounts.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
  27 </tr></table>
  28 <div class="refentry">
  29 <a name="GDrive"></a><div class="titlepage"></div>
  30 <div class="refnamediv"><table width="100%"><tr>
  31 <td valign="top">
  32 <h2><span class="refentrytitle"><a name="GDrive.top_of_page"></a>GDrive</span></h2>
  33 <p>GDrive — Drive management</p>
  34 </td>
  35 <td class="gallery_image" valign="top" align="right"></td>
  36 </tr></table></div>
  37 <div class="refsect1">
  38 <a name="GDrive.functions"></a><h2>Functions</h2>
  39 <div class="informaltable"><table class="informaltable" width="100%" border="0">
  40 <colgroup>
  41 <col width="150px" class="functions_return">
  42 <col class="functions_name">
  43 </colgroup>
  44 <tbody>
  45 <tr>
  46 <td class="function_type">
  47 <span class="returnvalue">char</span> *
  48 </td>
  49 <td class="function_name">
  50 <a class="link" href="GDrive.html#g-drive-get-name" title="g_drive_get_name ()">g_drive_get_name</a> <span class="c_punctuation">()</span>
  51 </td>
  52 </tr>
  53 <tr>
  54 <td class="function_type">
  55 <a class="link" href="GIcon.html" title="GIcon"><span class="returnvalue">GIcon</span></a> *
  56 </td>
  57 <td class="function_name">
  58 <a class="link" href="GDrive.html#g-drive-get-icon" title="g_drive_get_icon ()">g_drive_get_icon</a> <span class="c_punctuation">()</span>
  59 </td>
  60 </tr>
  61 <tr>
  62 <td class="function_type">
  63 <a class="link" href="GIcon.html" title="GIcon"><span class="returnvalue">GIcon</span></a> *
  64 </td>
  65 <td class="function_name">
  66 <a class="link" href="GDrive.html#g-drive-get-symbolic-icon" title="g_drive_get_symbolic_icon ()">g_drive_get_symbolic_icon</a> <span class="c_punctuation">()</span>
  67 </td>
  68 </tr>
  69 <tr>
  70 <td class="function_type">
  71 <a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
  72 </td>
  73 <td class="function_name">
  74 <a class="link" href="GDrive.html#g-drive-has-volumes" title="g_drive_has_volumes ()">g_drive_has_volumes</a> <span class="c_punctuation">()</span>
  75 </td>
  76 </tr>
  77 <tr>
  78 <td class="function_type">
  79 <a href="../glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *
  80 </td>
  81 <td class="function_name">
  82 <a class="link" href="GDrive.html#g-drive-get-volumes" title="g_drive_get_volumes ()">g_drive_get_volumes</a> <span class="c_punctuation">()</span>
  83 </td>
  84 </tr>
  85 <tr>
  86 <td class="function_type">
  87 <a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
  88 </td>
  89 <td class="function_name">
  90 <a class="link" href="GDrive.html#g-drive-can-eject" title="g_drive_can_eject ()">g_drive_can_eject</a> <span class="c_punctuation">()</span>
  91 </td>
  92 </tr>
  93 <tr>
  94 <td class="function_type">
  95 <a class="link" href="GDrive.html#GDriveStartStopType" title="enum GDriveStartStopType"><span class="returnvalue">GDriveStartStopType</span></a>
  96 </td>
  97 <td class="function_name">
  98 <a class="link" href="GDrive.html#g-drive-get-start-stop-type" title="g_drive_get_start_stop_type ()">g_drive_get_start_stop_type</a> <span class="c_punctuation">()</span>
  99 </td>
 100 </tr>
 101 <tr>
 102 <td class="function_type">
 103 <a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
 104 </td>
 105 <td class="function_name">
 106 <a class="link" href="GDrive.html#g-drive-can-start" title="g_drive_can_start ()">g_drive_can_start</a> <span class="c_punctuation">()</span>
 107 </td>
 108 </tr>
 109 <tr>
 110 <td class="function_type">
 111 <a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
 112 </td>
 113 <td class="function_name">
 114 <a class="link" href="GDrive.html#g-drive-can-start-degraded" title="g_drive_can_start_degraded ()">g_drive_can_start_degraded</a> <span class="c_punctuation">()</span>
 115 </td>
 116 </tr>
 117 <tr>
 118 <td class="function_type">
 119 <a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
 120 </td>
 121 <td class="function_name">
 122 <a class="link" href="GDrive.html#g-drive-can-stop" title="g_drive_can_stop ()">g_drive_can_stop</a> <span class="c_punctuation">()</span>
 123 </td>
 124 </tr>
 125 <tr>
 126 <td class="function_type">
 127 <a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
 128 </td>
 129 <td class="function_name">
 130 <a class="link" href="GDrive.html#g-drive-can-poll-for-media" title="g_drive_can_poll_for_media ()">g_drive_can_poll_for_media</a> <span class="c_punctuation">()</span>
 131 </td>
 132 </tr>
 133 <tr>
 134 <td class="function_type">
 135 <span class="returnvalue">void</span>
 136 </td>
 137 <td class="function_name">
 138 <a class="link" href="GDrive.html#g-drive-poll-for-media" title="g_drive_poll_for_media ()">g_drive_poll_for_media</a> <span class="c_punctuation">()</span>
 139 </td>
 140 </tr>
 141 <tr>
 142 <td class="function_type">
 143 <a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
 144 </td>
 145 <td class="function_name">
 146 <a class="link" href="GDrive.html#g-drive-poll-for-media-finish" title="g_drive_poll_for_media_finish ()">g_drive_poll_for_media_finish</a> <span class="c_punctuation">()</span>
 147 </td>
 148 </tr>
 149 <tr>
 150 <td class="function_type">
 151 <a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
 152 </td>
 153 <td class="function_name">
 154 <a class="link" href="GDrive.html#g-drive-has-media" title="g_drive_has_media ()">g_drive_has_media</a> <span class="c_punctuation">()</span>
 155 </td>
 156 </tr>
 157 <tr>
 158 <td class="function_type">
 159 <a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
 160 </td>
 161 <td class="function_name">
 162 <a class="link" href="GDrive.html#g-drive-is-media-check-automatic" title="g_drive_is_media_check_automatic ()">g_drive_is_media_check_automatic</a> <span class="c_punctuation">()</span>
 163 </td>
 164 </tr>
 165 <tr>
 166 <td class="function_type">
 167 <a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
 168 </td>
 169 <td class="function_name">
 170 <a class="link" href="GDrive.html#g-drive-is-removable" title="g_drive_is_removable ()">g_drive_is_removable</a> <span class="c_punctuation">()</span>
 171 </td>
 172 </tr>
 173 <tr>
 174 <td class="function_type">
 175 <a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
 176 </td>
 177 <td class="function_name">
 178 <a class="link" href="GDrive.html#g-drive-is-media-removable" title="g_drive_is_media_removable ()">g_drive_is_media_removable</a> <span class="c_punctuation">()</span>
 179 </td>
 180 </tr>
 181 <tr>
 182 <td class="function_type">
 183 <span class="returnvalue">void</span>
 184 </td>
 185 <td class="function_name">
 186 <a class="link" href="GDrive.html#g-drive-eject" title="g_drive_eject ()">g_drive_eject</a> <span class="c_punctuation">()</span>
 187 </td>
 188 </tr>
 189 <tr>
 190 <td class="function_type">
 191 <a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
 192 </td>
 193 <td class="function_name">
 194 <a class="link" href="GDrive.html#g-drive-eject-finish" title="g_drive_eject_finish ()">g_drive_eject_finish</a> <span class="c_punctuation">()</span>
 195 </td>
 196 </tr>
 197 <tr>
 198 <td class="function_type">
 199 <span class="returnvalue">void</span>
 200 </td>
 201 <td class="function_name">
 202 <a class="link" href="GDrive.html#g-drive-eject-with-operation" title="g_drive_eject_with_operation ()">g_drive_eject_with_operation</a> <span class="c_punctuation">()</span>
 203 </td>
 204 </tr>
 205 <tr>
 206 <td class="function_type">
 207 <a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
 208 </td>
 209 <td class="function_name">
 210 <a class="link" href="GDrive.html#g-drive-eject-with-operation-finish" title="g_drive_eject_with_operation_finish ()">g_drive_eject_with_operation_finish</a> <span class="c_punctuation">()</span>
 211 </td>
 212 </tr>
 213 <tr>
 214 <td class="function_type">
 215 <span class="returnvalue">void</span>
 216 </td>
 217 <td class="function_name">
 218 <a class="link" href="GDrive.html#g-drive-start" title="g_drive_start ()">g_drive_start</a> <span class="c_punctuation">()</span>
 219 </td>
 220 </tr>
 221 <tr>
 222 <td class="function_type">
 223 <a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
 224 </td>
 225 <td class="function_name">
 226 <a class="link" href="GDrive.html#g-drive-start-finish" title="g_drive_start_finish ()">g_drive_start_finish</a> <span class="c_punctuation">()</span>
 227 </td>
 228 </tr>
 229 <tr>
 230 <td class="function_type">
 231 <span class="returnvalue">void</span>
 232 </td>
 233 <td class="function_name">
 234 <a class="link" href="GDrive.html#g-drive-stop" title="g_drive_stop ()">g_drive_stop</a> <span class="c_punctuation">()</span>
 235 </td>
 236 </tr>
 237 <tr>
 238 <td class="function_type">
 239 <a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
 240 </td>
 241 <td class="function_name">
 242 <a class="link" href="GDrive.html#g-drive-stop-finish" title="g_drive_stop_finish ()">g_drive_stop_finish</a> <span class="c_punctuation">()</span>
 243 </td>
 244 </tr>
 245 <tr>
 246 <td class="function_type">
 247 <span class="returnvalue">char</span> **
 248 </td>
 249 <td class="function_name">
 250 <a class="link" href="GDrive.html#g-drive-enumerate-identifiers" title="g_drive_enumerate_identifiers ()">g_drive_enumerate_identifiers</a> <span class="c_punctuation">()</span>
 251 </td>
 252 </tr>
 253 <tr>
 254 <td class="function_type">
 255 <span class="returnvalue">char</span> *
 256 </td>
 257 <td class="function_name">
 258 <a class="link" href="GDrive.html#g-drive-get-identifier" title="g_drive_get_identifier ()">g_drive_get_identifier</a> <span class="c_punctuation">()</span>
 259 </td>
 260 </tr>
 261 <tr>
 262 <td class="function_type">const <a href="../glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
 263 </td>
 264 <td class="function_name">
 265 <a class="link" href="GDrive.html#g-drive-get-sort-key" title="g_drive_get_sort_key ()">g_drive_get_sort_key</a> <span class="c_punctuation">()</span>
 266 </td>
 267 </tr>
 268 </tbody>
 269 </table></div>
 270 </div>
 271 <div class="refsect1">
 272 <a name="GDrive.signals"></a><h2>Signals</h2>
 273 <div class="informaltable"><table class="informaltable" border="0">
 274 <colgroup>
 275 <col width="150px" class="signals_return">
 276 <col width="300px" class="signals_name">
 277 <col width="200px" class="signals_flags">
 278 </colgroup>
 279 <tbody>
 280 <tr>
 281 <td class="signal_type"><span class="returnvalue">void</span></td>
 282 <td class="signal_name"><a class="link" href="GDrive.html#GDrive-changed" title="The “changed” signal">changed</a></td>
 283 <td class="signal_flags"><a href="../gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></td>
 284 </tr>
 285 <tr>
 286 <td class="signal_type"><span class="returnvalue">void</span></td>
 287 <td class="signal_name"><a class="link" href="GDrive.html#GDrive-disconnected" title="The “disconnected” signal">disconnected</a></td>
 288 <td class="signal_flags"><a href="../gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></td>
 289 </tr>
 290 <tr>
 291 <td class="signal_type"><span class="returnvalue">void</span></td>
 292 <td class="signal_name"><a class="link" href="GDrive.html#GDrive-eject-button" title="The “eject-button” signal">eject-button</a></td>
 293 <td class="signal_flags"><a href="../gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></td>
 294 </tr>
 295 <tr>
 296 <td class="signal_type"><span class="returnvalue">void</span></td>
 297 <td class="signal_name"><a class="link" href="GDrive.html#GDrive-stop-button" title="The “stop-button” signal">stop-button</a></td>
 298 <td class="signal_flags"><a href="../gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></td>
 299 </tr>
 300 </tbody>
 301 </table></div>
 302 </div>
 303 <div class="refsect1">
 304 <a name="GDrive.other"></a><h2>Types and Values</h2>
 305 <div class="informaltable"><table class="informaltable" width="100%" border="0">
 306 <colgroup>
 307 <col width="150px" class="name">
 308 <col class="description">
 309 </colgroup>
 310 <tbody>
 311 <tr>
 312 <td class="datatype_keyword"> </td>
 313 <td class="function_name"><a class="link" href="GDrive.html#GDrive-struct" title="GDrive">GDrive</a></td>
 314 </tr>
 315 <tr>
 316 <td class="datatype_keyword">struct</td>
 317 <td class="function_name"><a class="link" href="GDrive.html#GDriveIface" title="struct GDriveIface">GDriveIface</a></td>
 318 </tr>
 319 <tr>
 320 <td class="datatype_keyword">enum</td>
 321 <td class="function_name"><a class="link" href="GDrive.html#GDriveStartFlags" title="enum GDriveStartFlags">GDriveStartFlags</a></td>
 322 </tr>
 323 <tr>
 324 <td class="datatype_keyword">enum</td>
 325 <td class="function_name"><a class="link" href="GDrive.html#GDriveStartStopType" title="enum GDriveStartStopType">GDriveStartStopType</a></td>
 326 </tr>
 327 </tbody>
 328 </table></div>
 329 </div>
 330 <div class="refsect1">
 331 <a name="GDrive.object-hierarchy"></a><h2>Object Hierarchy</h2>
 332 <pre class="screen">    <a href="https://developer.gnome.org/gobject/unstable/GTypeModule.html">GInterface</a>
 333     <span class="lineart">╰──</span> GDrive
 334 </pre>
 335 </div>
 336 <div class="refsect1">
 337 <a name="GDrive.prerequisites"></a><h2>Prerequisites</h2>
 338 <p>
 339 GDrive requires
 340  <a href="../gobject-The-Base-Object-Type.html#GObject-struct">GObject</a>.</p>
 341 </div>
 342 <div class="refsect1">
 343 <a name="GDrive.includes"></a><h2>Includes</h2>
 344 <pre class="synopsis">#include &lt;gio/gio.h&gt;
 345 </pre>
 346 </div>
 347 <div class="refsect1">
 348 <a name="GDrive.description"></a><h2>Description</h2>
 349 <p><a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a> - this represent a piece of hardware connected to the machine.
 350 It's generally only created for removable hardware or hardware with
 351 removable media.</p>
 352 <p><a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a> is a container class for <a class="link" href="GVolume.html" title="GVolume"><span class="type">GVolume</span></a> objects that stem from
 353 the same piece of media. As such, <a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a> abstracts a drive with
 354 (or without) removable media and provides operations for querying
 355 whether media is available, determining whether media change is
 356 automatically detected and ejecting the media.</p>
 357 <p>If the <a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a> reports that media isn't automatically detected, one
 358 can poll for media; typically one should not do this periodically
 359 as a poll for media operation is potententially expensive and may
 360 spin up the drive creating noise.</p>
 361 <p><a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a> supports starting and stopping drives with authentication
 362 support for the former. This can be used to support a diverse set
 363 of use cases including connecting/disconnecting iSCSI devices,
 364 powering down external disk enclosures and starting/stopping
 365 multi-disk devices such as RAID devices. Note that the actual
 366 semantics and side-effects of starting/stopping a <a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a> may vary
 367 according to implementation. To choose the correct verbs in e.g. a
 368 file manager, use <a class="link" href="GDrive.html#g-drive-get-start-stop-type" title="g_drive_get_start_stop_type ()"><code class="function">g_drive_get_start_stop_type()</code></a>.</p>
 369 <p>For porting from GnomeVFS note that there is no equivalent of
 370 <a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a> in that API.</p>
 371 </div>
 372 <div class="refsect1">
 373 <a name="GDrive.functions_details"></a><h2>Functions</h2>
 374 <div class="refsect2">
 375 <a name="g-drive-get-name"></a><h3>g_drive_get_name ()</h3>
 376 <pre class="programlisting"><span class="returnvalue">char</span> *
 377 g_drive_get_name (<em class="parameter"><code><a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a> *drive</code></em>);</pre>
 378 <p>Gets the name of <em class="parameter"><code>drive</code></em>
 379 .</p>
 380 <div class="refsect3">
 381 <a name="g-drive-get-name.parameters"></a><h4>Parameters</h4>
 382 <div class="informaltable"><table class="informaltable" width="100%" border="0">
 383 <colgroup>
 384 <col width="150px" class="parameters_name">
 385 <col class="parameters_description">
 386 <col width="200px" class="parameters_annotations">
 387 </colgroup>
 388 <tbody><tr>
 389 <td class="parameter_name"><p>drive</p></td>
 390 <td class="parameter_description"><p>a <a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a>.</p></td>
 391 <td class="parameter_annotations"> </td>
 392 </tr></tbody>
 393 </table></div>
 394 </div>
 395 <div class="refsect3">
 396 <a name="g-drive-get-name.returns"></a><h4>Returns</h4>
 397 <p> a string containing <em class="parameter"><code>drive</code></em>
 398 's name. The returned
 399 string should be freed when no longer needed.</p>
 400 </div>
 401 </div>
 402 <hr>
 403 <div class="refsect2">
 404 <a name="g-drive-get-icon"></a><h3>g_drive_get_icon ()</h3>
 405 <pre class="programlisting"><a class="link" href="GIcon.html" title="GIcon"><span class="returnvalue">GIcon</span></a> *
 406 g_drive_get_icon (<em class="parameter"><code><a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a> *drive</code></em>);</pre>
 407 <p>Gets the icon for <em class="parameter"><code>drive</code></em>
 408 .</p>
 409 <div class="refsect3">
 410 <a name="g-drive-get-icon.parameters"></a><h4>Parameters</h4>
 411 <div class="informaltable"><table class="informaltable" width="100%" border="0">
 412 <colgroup>
 413 <col width="150px" class="parameters_name">
 414 <col class="parameters_description">
 415 <col width="200px" class="parameters_annotations">
 416 </colgroup>
 417 <tbody><tr>
 418 <td class="parameter_name"><p>drive</p></td>
 419 <td class="parameter_description"><p>a <a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a>.</p></td>
 420 <td class="parameter_annotations"> </td>
 421 </tr></tbody>
 422 </table></div>
 423 </div>
 424 <div class="refsect3">
 425 <a name="g-drive-get-icon.returns"></a><h4>Returns</h4>
 426 <p> <a class="link" href="GIcon.html" title="GIcon"><span class="type">GIcon</span></a> for the <em class="parameter"><code>drive</code></em>
 427 .
 428 Free the returned object with <a href="../gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. </p>
 429 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 430 </div>
 431 </div>
 432 <hr>
 433 <div class="refsect2">
 434 <a name="g-drive-get-symbolic-icon"></a><h3>g_drive_get_symbolic_icon ()</h3>
 435 <pre class="programlisting"><a class="link" href="GIcon.html" title="GIcon"><span class="returnvalue">GIcon</span></a> *
 436 g_drive_get_symbolic_icon (<em class="parameter"><code><a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a> *drive</code></em>);</pre>
 437 <p>Gets the icon for <em class="parameter"><code>drive</code></em>
 438 .</p>
 439 <div class="refsect3">
 440 <a name="g-drive-get-symbolic-icon.parameters"></a><h4>Parameters</h4>
 441 <div class="informaltable"><table class="informaltable" width="100%" border="0">
 442 <colgroup>
 443 <col width="150px" class="parameters_name">
 444 <col class="parameters_description">
 445 <col width="200px" class="parameters_annotations">
 446 </colgroup>
 447 <tbody><tr>
 448 <td class="parameter_name"><p>drive</p></td>
 449 <td class="parameter_description"><p>a <a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a>.</p></td>
 450 <td class="parameter_annotations"> </td>
 451 </tr></tbody>
 452 </table></div>
 453 </div>
 454 <div class="refsect3">
 455 <a name="g-drive-get-symbolic-icon.returns"></a><h4>Returns</h4>
 456 <p> symbolic <a class="link" href="GIcon.html" title="GIcon"><span class="type">GIcon</span></a> for the <em class="parameter"><code>drive</code></em>
 457 .
 458 Free the returned object with <a href="../gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. </p>
 459 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 460 </div>
 461 <p class="since">Since: <a class="link" href="api-index-2-34.html#api-index-2.34">2.34</a></p>
 462 </div>
 463 <hr>
 464 <div class="refsect2">
 465 <a name="g-drive-has-volumes"></a><h3>g_drive_has_volumes ()</h3>
 466 <pre class="programlisting"><a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
 467 g_drive_has_volumes (<em class="parameter"><code><a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a> *drive</code></em>);</pre>
 468 <p>Check if <em class="parameter"><code>drive</code></em>
 469  has any mountable volumes.</p>
 470 <div class="refsect3">
 471 <a name="g-drive-has-volumes.parameters"></a><h4>Parameters</h4>
 472 <div class="informaltable"><table class="informaltable" width="100%" border="0">
 473 <colgroup>
 474 <col width="150px" class="parameters_name">
 475 <col class="parameters_description">
 476 <col width="200px" class="parameters_annotations">
 477 </colgroup>
 478 <tbody><tr>
 479 <td class="parameter_name"><p>drive</p></td>
 480 <td class="parameter_description"><p>a <a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a>.</p></td>
 481 <td class="parameter_annotations"> </td>
 482 </tr></tbody>
 483 </table></div>
 484 </div>
 485 <div class="refsect3">
 486 <a name="g-drive-has-volumes.returns"></a><h4>Returns</h4>
 487 <p> <a href="../glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the <em class="parameter"><code>drive</code></em>
 488 contains volumes, <a href="../glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</p>
 489 </div>
 490 </div>
 491 <hr>
 492 <div class="refsect2">
 493 <a name="g-drive-get-volumes"></a><h3>g_drive_get_volumes ()</h3>
 494 <pre class="programlisting"><a href="../glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *
 495 g_drive_get_volumes (<em class="parameter"><code><a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a> *drive</code></em>);</pre>
 496 <p>Get a list of mountable volumes for <em class="parameter"><code>drive</code></em>
 497 .</p>
 498 <p>The returned list should be freed with <a href="../glib-Doubly-Linked-Lists.html#g-list-free"><code class="function">g_list_free()</code></a>, after
 499 its elements have been unreffed with <a href="../gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.</p>
 500 <div class="refsect3">
 501 <a name="g-drive-get-volumes.parameters"></a><h4>Parameters</h4>
 502 <div class="informaltable"><table class="informaltable" width="100%" border="0">
 503 <colgroup>
 504 <col width="150px" class="parameters_name">
 505 <col class="parameters_description">
 506 <col width="200px" class="parameters_annotations">
 507 </colgroup>
 508 <tbody><tr>
 509 <td class="parameter_name"><p>drive</p></td>
 510 <td class="parameter_description"><p>a <a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a>.</p></td>
 511 <td class="parameter_annotations"> </td>
 512 </tr></tbody>
 513 </table></div>
 514 </div>
 515 <div class="refsect3">
 516 <a name="g-drive-get-volumes.returns"></a><h4>Returns</h4>
 517 <p> <a href="../glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> containing any <a class="link" href="GVolume.html" title="GVolume"><span class="type">GVolume</span></a> objects on the given <em class="parameter"><code>drive</code></em>
 518 . </p>
 519 <p><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> GVolume][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 520 </div>
 521 </div>
 522 <hr>
 523 <div class="refsect2">
 524 <a name="g-drive-can-eject"></a><h3>g_drive_can_eject ()</h3>
 525 <pre class="programlisting"><a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
 526 g_drive_can_eject (<em class="parameter"><code><a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a> *drive</code></em>);</pre>
 527 <p>Checks if a drive can be ejected.</p>
 528 <div class="refsect3">
 529 <a name="g-drive-can-eject.parameters"></a><h4>Parameters</h4>
 530 <div class="informaltable"><table class="informaltable" width="100%" border="0">
 531 <colgroup>
 532 <col width="150px" class="parameters_name">
 533 <col class="parameters_description">
 534 <col width="200px" class="parameters_annotations">
 535 </colgroup>
 536 <tbody><tr>
 537 <td class="parameter_name"><p>drive</p></td>
 538 <td class="parameter_description"><p>a <a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a>.</p></td>
 539 <td class="parameter_annotations"> </td>
 540 </tr></tbody>
 541 </table></div>
 542 </div>
 543 <div class="refsect3">
 544 <a name="g-drive-can-eject.returns"></a><h4>Returns</h4>
 545 <p> <a href="../glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the <em class="parameter"><code>drive</code></em>
 546 can be ejected, <a href="../glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</p>
 547 </div>
 548 </div>
 549 <hr>
 550 <div class="refsect2">
 551 <a name="g-drive-get-start-stop-type"></a><h3>g_drive_get_start_stop_type ()</h3>
 552 <pre class="programlisting"><a class="link" href="GDrive.html#GDriveStartStopType" title="enum GDriveStartStopType"><span class="returnvalue">GDriveStartStopType</span></a>
 553 g_drive_get_start_stop_type (<em class="parameter"><code><a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a> *drive</code></em>);</pre>
 554 <p>Gets a hint about how a drive can be started/stopped.</p>
 555 <div class="refsect3">
 556 <a name="g-drive-get-start-stop-type.parameters"></a><h4>Parameters</h4>
 557 <div class="informaltable"><table class="informaltable" width="100%" border="0">
 558 <colgroup>
 559 <col width="150px" class="parameters_name">
 560 <col class="parameters_description">
 561 <col width="200px" class="parameters_annotations">
 562 </colgroup>
 563 <tbody><tr>
 564 <td class="parameter_name"><p>drive</p></td>
 565 <td class="parameter_description"><p>a <a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a>.</p></td>
 566 <td class="parameter_annotations"> </td>
 567 </tr></tbody>
 568 </table></div>
 569 </div>
 570 <div class="refsect3">
 571 <a name="g-drive-get-start-stop-type.returns"></a><h4>Returns</h4>
 572 <p> A value from the <a class="link" href="GDrive.html#GDriveStartStopType" title="enum GDriveStartStopType"><span class="type">GDriveStartStopType</span></a> enumeration.</p>
 573 </div>
 574 <p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
 575 </div>
 576 <hr>
 577 <div class="refsect2">
 578 <a name="g-drive-can-start"></a><h3>g_drive_can_start ()</h3>
 579 <pre class="programlisting"><a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
 580 g_drive_can_start (<em class="parameter"><code><a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a> *drive</code></em>);</pre>
 581 <p>Checks if a drive can be started.</p>
 582 <div class="refsect3">
 583 <a name="g-drive-can-start.parameters"></a><h4>Parameters</h4>
 584 <div class="informaltable"><table class="informaltable" width="100%" border="0">
 585 <colgroup>
 586 <col width="150px" class="parameters_name">
 587 <col class="parameters_description">
 588 <col width="200px" class="parameters_annotations">
 589 </colgroup>
 590 <tbody><tr>
 591 <td class="parameter_name"><p>drive</p></td>
 592 <td class="parameter_description"><p>a <a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a>.</p></td>
 593 <td class="parameter_annotations"> </td>
 594 </tr></tbody>
 595 </table></div>
 596 </div>
 597 <div class="refsect3">
 598 <a name="g-drive-can-start.returns"></a><h4>Returns</h4>
 599 <p> <a href="../glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the <em class="parameter"><code>drive</code></em>
 600 can be started, <a href="../glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</p>
 601 </div>
 602 <p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
 603 </div>
 604 <hr>
 605 <div class="refsect2">
 606 <a name="g-drive-can-start-degraded"></a><h3>g_drive_can_start_degraded ()</h3>
 607 <pre class="programlisting"><a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
 608 g_drive_can_start_degraded (<em class="parameter"><code><a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a> *drive</code></em>);</pre>
 609 <p>Checks if a drive can be started degraded.</p>
 610 <div class="refsect3">
 611 <a name="g-drive-can-start-degraded.parameters"></a><h4>Parameters</h4>
 612 <div class="informaltable"><table class="informaltable" width="100%" border="0">
 613 <colgroup>
 614 <col width="150px" class="parameters_name">
 615 <col class="parameters_description">
 616 <col width="200px" class="parameters_annotations">
 617 </colgroup>
 618 <tbody><tr>
 619 <td class="parameter_name"><p>drive</p></td>
 620 <td class="parameter_description"><p>a <a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a>.</p></td>
 621 <td class="parameter_annotations"> </td>
 622 </tr></tbody>
 623 </table></div>
 624 </div>
 625 <div class="refsect3">
 626 <a name="g-drive-can-start-degraded.returns"></a><h4>Returns</h4>
 627 <p> <a href="../glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the <em class="parameter"><code>drive</code></em>
 628 can be started degraded, <a href="../glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</p>
 629 </div>
 630 <p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
 631 </div>
 632 <hr>
 633 <div class="refsect2">
 634 <a name="g-drive-can-stop"></a><h3>g_drive_can_stop ()</h3>
 635 <pre class="programlisting"><a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
 636 g_drive_can_stop (<em class="parameter"><code><a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a> *drive</code></em>);</pre>
 637 <p>Checks if a drive can be stopped.</p>
 638 <div class="refsect3">
 639 <a name="g-drive-can-stop.parameters"></a><h4>Parameters</h4>
 640 <div class="informaltable"><table class="informaltable" width="100%" border="0">
 641 <colgroup>
 642 <col width="150px" class="parameters_name">
 643 <col class="parameters_description">
 644 <col width="200px" class="parameters_annotations">
 645 </colgroup>
 646 <tbody><tr>
 647 <td class="parameter_name"><p>drive</p></td>
 648 <td class="parameter_description"><p>a <a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a>.</p></td>
 649 <td class="parameter_annotations"> </td>
 650 </tr></tbody>
 651 </table></div>
 652 </div>
 653 <div class="refsect3">
 654 <a name="g-drive-can-stop.returns"></a><h4>Returns</h4>
 655 <p> <a href="../glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the <em class="parameter"><code>drive</code></em>
 656 can be stopped, <a href="../glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</p>
 657 </div>
 658 <p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
 659 </div>
 660 <hr>
 661 <div class="refsect2">
 662 <a name="g-drive-can-poll-for-media"></a><h3>g_drive_can_poll_for_media ()</h3>
 663 <pre class="programlisting"><a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
 664 g_drive_can_poll_for_media (<em class="parameter"><code><a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a> *drive</code></em>);</pre>
 665 <p>Checks if a drive can be polled for media changes.</p>
 666 <div class="refsect3">
 667 <a name="g-drive-can-poll-for-media.parameters"></a><h4>Parameters</h4>
 668 <div class="informaltable"><table class="informaltable" width="100%" border="0">
 669 <colgroup>
 670 <col width="150px" class="parameters_name">
 671 <col class="parameters_description">
 672 <col width="200px" class="parameters_annotations">
 673 </colgroup>
 674 <tbody><tr>
 675 <td class="parameter_name"><p>drive</p></td>
 676 <td class="parameter_description"><p>a <a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a>.</p></td>
 677 <td class="parameter_annotations"> </td>
 678 </tr></tbody>
 679 </table></div>
 680 </div>
 681 <div class="refsect3">
 682 <a name="g-drive-can-poll-for-media.returns"></a><h4>Returns</h4>
 683 <p> <a href="../glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the <em class="parameter"><code>drive</code></em>
 684 can be polled for media changes,
 685 <a href="../glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</p>
 686 </div>
 687 </div>
 688 <hr>
 689 <div class="refsect2">
 690 <a name="g-drive-poll-for-media"></a><h3>g_drive_poll_for_media ()</h3>
 691 <pre class="programlisting"><span class="returnvalue">void</span>
 692 g_drive_poll_for_media (<em class="parameter"><code><a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a> *drive</code></em>,
 693                         <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
 694                         <em class="parameter"><code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
 695                         <em class="parameter"><code><a href="../glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
 696 <p>Asynchronously polls <em class="parameter"><code>drive</code></em>
 697  to see if media has been inserted or removed.</p>
 698 <p>When the operation is finished, <em class="parameter"><code>callback</code></em>
 699  will be called.
 700 You can then call <a class="link" href="GDrive.html#g-drive-poll-for-media-finish" title="g_drive_poll_for_media_finish ()"><code class="function">g_drive_poll_for_media_finish()</code></a> to obtain the
 701 result of the operation.</p>
 702 <div class="refsect3">
 703 <a name="g-drive-poll-for-media.parameters"></a><h4>Parameters</h4>
 704 <div class="informaltable"><table class="informaltable" width="100%" border="0">
 705 <colgroup>
 706 <col width="150px" class="parameters_name">
 707 <col class="parameters_description">
 708 <col width="200px" class="parameters_annotations">
 709 </colgroup>
 710 <tbody>
 711 <tr>
 712 <td class="parameter_name"><p>drive</p></td>
 713 <td class="parameter_description"><p>a <a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a>.</p></td>
 714 <td class="parameter_annotations"> </td>
 715 </tr>
 716 <tr>
 717 <td class="parameter_name"><p>cancellable</p></td>
 718 <td class="parameter_description"><p> optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </p></td>
 719 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
 720 </tr>
 721 <tr>
 722 <td class="parameter_name"><p>callback</p></td>
 723 <td class="parameter_description"><p> a <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a>, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
 724 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
 725 </tr>
 726 <tr>
 727 <td class="parameter_name"><p>user_data</p></td>
 728 <td class="parameter_description"><p>user data to pass to <em class="parameter"><code>callback</code></em>
 729 </p></td>
 730 <td class="parameter_annotations"> </td>
 731 </tr>
 732 </tbody>
 733 </table></div>
 734 </div>
 735 </div>
 736 <hr>
 737 <div class="refsect2">
 738 <a name="g-drive-poll-for-media-finish"></a><h3>g_drive_poll_for_media_finish ()</h3>
 739 <pre class="programlisting"><a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
 740 g_drive_poll_for_media_finish (<em class="parameter"><code><a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a> *drive</code></em>,
 741                                <em class="parameter"><code><a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> *result</code></em>,
 742                                <em class="parameter"><code><a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
 743 <p>Finishes an operation started with <a class="link" href="GDrive.html#g-drive-poll-for-media" title="g_drive_poll_for_media ()"><code class="function">g_drive_poll_for_media()</code></a> on a drive.</p>
 744 <div class="refsect3">
 745 <a name="g-drive-poll-for-media-finish.parameters"></a><h4>Parameters</h4>
 746 <div class="informaltable"><table class="informaltable" width="100%" border="0">
 747 <colgroup>
 748 <col width="150px" class="parameters_name">
 749 <col class="parameters_description">
 750 <col width="200px" class="parameters_annotations">
 751 </colgroup>
 752 <tbody>
 753 <tr>
 754 <td class="parameter_name"><p>drive</p></td>
 755 <td class="parameter_description"><p>a <a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a>.</p></td>
 756 <td class="parameter_annotations"> </td>
 757 </tr>
 758 <tr>
 759 <td class="parameter_name"><p>result</p></td>
 760 <td class="parameter_description"><p>a <a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a>.</p></td>
 761 <td class="parameter_annotations"> </td>
 762 </tr>
 763 <tr>
 764 <td class="parameter_name"><p>error</p></td>
 765 <td class="parameter_description"><p>a <a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
 766 <td class="parameter_annotations"> </td>
 767 </tr>
 768 </tbody>
 769 </table></div>
 770 </div>
 771 <div class="refsect3">
 772 <a name="g-drive-poll-for-media-finish.returns"></a><h4>Returns</h4>
 773 <p> <a href="../glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the drive has been poll_for_mediaed successfully,
 774 <a href="../glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</p>
 775 </div>
 776 </div>
 777 <hr>
 778 <div class="refsect2">
 779 <a name="g-drive-has-media"></a><h3>g_drive_has_media ()</h3>
 780 <pre class="programlisting"><a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
 781 g_drive_has_media (<em class="parameter"><code><a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a> *drive</code></em>);</pre>
 782 <p>Checks if the <em class="parameter"><code>drive</code></em>
 783  has media. Note that the OS may not be polling
 784 the drive for media changes; see <a class="link" href="GDrive.html#g-drive-is-media-check-automatic" title="g_drive_is_media_check_automatic ()"><code class="function">g_drive_is_media_check_automatic()</code></a>
 785 for more details.</p>
 786 <div class="refsect3">
 787 <a name="g-drive-has-media.parameters"></a><h4>Parameters</h4>
 788 <div class="informaltable"><table class="informaltable" width="100%" border="0">
 789 <colgroup>
 790 <col width="150px" class="parameters_name">
 791 <col class="parameters_description">
 792 <col width="200px" class="parameters_annotations">
 793 </colgroup>
 794 <tbody><tr>
 795 <td class="parameter_name"><p>drive</p></td>
 796 <td class="parameter_description"><p>a <a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a>.</p></td>
 797 <td class="parameter_annotations"> </td>
 798 </tr></tbody>
 799 </table></div>
 800 </div>
 801 <div class="refsect3">
 802 <a name="g-drive-has-media.returns"></a><h4>Returns</h4>
 803 <p> <a href="../glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <em class="parameter"><code>drive</code></em>
 804 has media, <a href="../glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</p>
 805 </div>
 806 </div>
 807 <hr>
 808 <div class="refsect2">
 809 <a name="g-drive-is-media-check-automatic"></a><h3>g_drive_is_media_check_automatic ()</h3>
 810 <pre class="programlisting"><a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
 811 g_drive_is_media_check_automatic (<em class="parameter"><code><a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a> *drive</code></em>);</pre>
 812 <p>Checks if <em class="parameter"><code>drive</code></em>
 813  is capabable of automatically detecting media changes.</p>
 814 <div class="refsect3">
 815 <a name="g-drive-is-media-check-automatic.parameters"></a><h4>Parameters</h4>
 816 <div class="informaltable"><table class="informaltable" width="100%" border="0">
 817 <colgroup>
 818 <col width="150px" class="parameters_name">
 819 <col class="parameters_description">
 820 <col width="200px" class="parameters_annotations">
 821 </colgroup>
 822 <tbody><tr>
 823 <td class="parameter_name"><p>drive</p></td>
 824 <td class="parameter_description"><p>a <a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a>.</p></td>
 825 <td class="parameter_annotations"> </td>
 826 </tr></tbody>
 827 </table></div>
 828 </div>
 829 <div class="refsect3">
 830 <a name="g-drive-is-media-check-automatic.returns"></a><h4>Returns</h4>
 831 <p> <a href="../glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the <em class="parameter"><code>drive</code></em>
 832 is capabable of automatically detecting
 833 media changes, <a href="../glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</p>
 834 </div>
 835 </div>
 836 <hr>
 837 <div class="refsect2">
 838 <a name="g-drive-is-removable"></a><h3>g_drive_is_removable ()</h3>
 839 <pre class="programlisting"><a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
 840 g_drive_is_removable (<em class="parameter"><code><a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a> *drive</code></em>);</pre>
 841 <p>Checks if the <a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a> and/or its media is considered removable by the user.
 842 See <a class="link" href="GDrive.html#g-drive-is-media-removable" title="g_drive_is_media_removable ()"><code class="function">g_drive_is_media_removable()</code></a>.</p>
 843 <div class="refsect3">
 844 <a name="g-drive-is-removable.parameters"></a><h4>Parameters</h4>
 845 <div class="informaltable"><table class="informaltable" width="100%" border="0">
 846 <colgroup>
 847 <col width="150px" class="parameters_name">
 848 <col class="parameters_description">
 849 <col width="200px" class="parameters_annotations">
 850 </colgroup>
 851 <tbody><tr>
 852 <td class="parameter_name"><p>drive</p></td>
 853 <td class="parameter_description"><p>a <a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a>.</p></td>
 854 <td class="parameter_annotations"> </td>
 855 </tr></tbody>
 856 </table></div>
 857 </div>
 858 <div class="refsect3">
 859 <a name="g-drive-is-removable.returns"></a><h4>Returns</h4>
 860 <p> <a href="../glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <em class="parameter"><code>drive</code></em>
 861 and/or its media is considered removable, <a href="../glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</p>
 862 </div>
 863 <p class="since">Since: <a class="link" href="api-index-2-50.html#api-index-2.50">2.50</a></p>
 864 </div>
 865 <hr>
 866 <div class="refsect2">
 867 <a name="g-drive-is-media-removable"></a><h3>g_drive_is_media_removable ()</h3>
 868 <pre class="programlisting"><a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
 869 g_drive_is_media_removable (<em class="parameter"><code><a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a> *drive</code></em>);</pre>
 870 <p>Checks if the <em class="parameter"><code>drive</code></em>
 871  supports removable media.</p>
 872 <div class="refsect3">
 873 <a name="g-drive-is-media-removable.parameters"></a><h4>Parameters</h4>
 874 <div class="informaltable"><table class="informaltable" width="100%" border="0">
 875 <colgroup>
 876 <col width="150px" class="parameters_name">
 877 <col class="parameters_description">
 878 <col width="200px" class="parameters_annotations">
 879 </colgroup>
 880 <tbody><tr>
 881 <td class="parameter_name"><p>drive</p></td>
 882 <td class="parameter_description"><p>a <a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a>.</p></td>
 883 <td class="parameter_annotations"> </td>
 884 </tr></tbody>
 885 </table></div>
 886 </div>
 887 <div class="refsect3">
 888 <a name="g-drive-is-media-removable.returns"></a><h4>Returns</h4>
 889 <p> <a href="../glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <em class="parameter"><code>drive</code></em>
 890 supports removable media, <a href="../glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</p>
 891 </div>
 892 </div>
 893 <hr>
 894 <div class="refsect2">
 895 <a name="g-drive-eject"></a><h3>g_drive_eject ()</h3>
 896 <pre class="programlisting"><span class="returnvalue">void</span>
 897 g_drive_eject (<em class="parameter"><code><a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a> *drive</code></em>,
 898                <em class="parameter"><code><a class="link" href="GMount.html#GMountUnmountFlags" title="enum GMountUnmountFlags"><span class="type">GMountUnmountFlags</span></a> flags</code></em>,
 899                <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
 900                <em class="parameter"><code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
 901                <em class="parameter"><code><a href="../glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
 902 <div class="warning">
 903 <p><code class="literal">g_drive_eject</code> has been deprecated since version 2.22 and should not be used in newly-written code.</p>
 904 <p>Use <a class="link" href="GDrive.html#g-drive-eject-with-operation" title="g_drive_eject_with_operation ()"><code class="function">g_drive_eject_with_operation()</code></a> instead.</p>
 905 </div>
 906 <p>Asynchronously ejects a drive.</p>
 907 <p>When the operation is finished, <em class="parameter"><code>callback</code></em>
 908  will be called.
 909 You can then call <a class="link" href="GDrive.html#g-drive-eject-finish" title="g_drive_eject_finish ()"><code class="function">g_drive_eject_finish()</code></a> to obtain the
 910 result of the operation.</p>
 911 <div class="refsect3">
 912 <a name="g-drive-eject.parameters"></a><h4>Parameters</h4>
 913 <div class="informaltable"><table class="informaltable" width="100%" border="0">
 914 <colgroup>
 915 <col width="150px" class="parameters_name">
 916 <col class="parameters_description">
 917 <col width="200px" class="parameters_annotations">
 918 </colgroup>
 919 <tbody>
 920 <tr>
 921 <td class="parameter_name"><p>drive</p></td>
 922 <td class="parameter_description"><p>a <a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a>.</p></td>
 923 <td class="parameter_annotations"> </td>
 924 </tr>
 925 <tr>
 926 <td class="parameter_name"><p>flags</p></td>
 927 <td class="parameter_description"><p>flags affecting the unmount if required for eject</p></td>
 928 <td class="parameter_annotations"> </td>
 929 </tr>
 930 <tr>
 931 <td class="parameter_name"><p>cancellable</p></td>
 932 <td class="parameter_description"><p> optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </p></td>
 933 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
 934 </tr>
 935 <tr>
 936 <td class="parameter_name"><p>callback</p></td>
 937 <td class="parameter_description"><p> a <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a>, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
 938 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
 939 </tr>
 940 <tr>
 941 <td class="parameter_name"><p>user_data</p></td>
 942 <td class="parameter_description"><p>user data to pass to <em class="parameter"><code>callback</code></em>
 943 </p></td>
 944 <td class="parameter_annotations"> </td>
 945 </tr>
 946 </tbody>
 947 </table></div>
 948 </div>
 949 </div>
 950 <hr>
 951 <div class="refsect2">
 952 <a name="g-drive-eject-finish"></a><h3>g_drive_eject_finish ()</h3>
 953 <pre class="programlisting"><a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
 954 g_drive_eject_finish (<em class="parameter"><code><a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a> *drive</code></em>,
 955                       <em class="parameter"><code><a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> *result</code></em>,
 956                       <em class="parameter"><code><a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
 957 <div class="warning">
 958 <p><code class="literal">g_drive_eject_finish</code> has been deprecated since version 2.22 and should not be used in newly-written code.</p>
 959 <p>Use <a class="link" href="GDrive.html#g-drive-eject-with-operation-finish" title="g_drive_eject_with_operation_finish ()"><code class="function">g_drive_eject_with_operation_finish()</code></a> instead.</p>
 960 </div>
 961 <p>Finishes ejecting a drive.</p>
 962 <div class="refsect3">
 963 <a name="g-drive-eject-finish.parameters"></a><h4>Parameters</h4>
 964 <div class="informaltable"><table class="informaltable" width="100%" border="0">
 965 <colgroup>
 966 <col width="150px" class="parameters_name">
 967 <col class="parameters_description">
 968 <col width="200px" class="parameters_annotations">
 969 </colgroup>
 970 <tbody>
 971 <tr>
 972 <td class="parameter_name"><p>drive</p></td>
 973 <td class="parameter_description"><p>a <a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a>.</p></td>
 974 <td class="parameter_annotations"> </td>
 975 </tr>
 976 <tr>
 977 <td class="parameter_name"><p>result</p></td>
 978 <td class="parameter_description"><p>a <a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a>.</p></td>
 979 <td class="parameter_annotations"> </td>
 980 </tr>
 981 <tr>
 982 <td class="parameter_name"><p>error</p></td>
 983 <td class="parameter_description"><p>a <a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
 984 <td class="parameter_annotations"> </td>
 985 </tr>
 986 </tbody>
 987 </table></div>
 988 </div>
 989 <div class="refsect3">
 990 <a name="g-drive-eject-finish.returns"></a><h4>Returns</h4>
 991 <p> <a href="../glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the drive has been ejected successfully,
 992 <a href="../glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</p>
 993 </div>
 994 </div>
 995 <hr>
 996 <div class="refsect2">
 997 <a name="g-drive-eject-with-operation"></a><h3>g_drive_eject_with_operation ()</h3>
 998 <pre class="programlisting"><span class="returnvalue">void</span>
 999 g_drive_eject_with_operation (<em class="parameter"><code><a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a> *drive</code></em>,
1000                               <em class="parameter"><code><a class="link" href="GMount.html#GMountUnmountFlags" title="enum GMountUnmountFlags"><span class="type">GMountUnmountFlags</span></a> flags</code></em>,
1001                               <em class="parameter"><code><a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a> *mount_operation</code></em>,
1002                               <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
1003                               <em class="parameter"><code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
1004                               <em class="parameter"><code><a href="../glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
1005 <p>Ejects a drive. This is an asynchronous operation, and is
1006 finished by calling <a class="link" href="GDrive.html#g-drive-eject-with-operation-finish" title="g_drive_eject_with_operation_finish ()"><code class="function">g_drive_eject_with_operation_finish()</code></a> with the <em class="parameter"><code>drive</code></em>
1007
1008 and <a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> data returned in the <em class="parameter"><code>callback</code></em>
1009 .</p>
1010 <div class="refsect3">
1011 <a name="g-drive-eject-with-operation.parameters"></a><h4>Parameters</h4>
1012 <div class="informaltable"><table class="informaltable" width="100%" border="0">
1013 <colgroup>
1014 <col width="150px" class="parameters_name">
1015 <col class="parameters_description">
1016 <col width="200px" class="parameters_annotations">
1017 </colgroup>
1018 <tbody>
1019 <tr>
1020 <td class="parameter_name"><p>drive</p></td>
1021 <td class="parameter_description"><p>a <a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a>.</p></td>
1022 <td class="parameter_annotations"> </td>
1023 </tr>
1024 <tr>
1025 <td class="parameter_name"><p>flags</p></td>
1026 <td class="parameter_description"><p>flags affecting the unmount if required for eject</p></td>
1027 <td class="parameter_annotations"> </td>
1028 </tr>
1029 <tr>
1030 <td class="parameter_name"><p>mount_operation</p></td>
1031 <td class="parameter_description"><p> a <a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a> or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to avoid
1032 user interaction. </p></td>
1033 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
1034 </tr>
1035 <tr>
1036 <td class="parameter_name"><p>cancellable</p></td>
1037 <td class="parameter_description"><p> optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </p></td>
1038 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
1039 </tr>
1040 <tr>
1041 <td class="parameter_name"><p>callback</p></td>
1042 <td class="parameter_description"><p> a <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a>, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
1043 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
1044 </tr>
1045 <tr>
1046 <td class="parameter_name"><p>user_data</p></td>
1047 <td class="parameter_description"><p>user data passed to <em class="parameter"><code>callback</code></em>
1048 .</p></td>
1049 <td class="parameter_annotations"> </td>
1050 </tr>
1051 </tbody>
1052 </table></div>
1053 </div>
1054 <p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
1055 </div>
1056 <hr>
1057 <div class="refsect2">
1058 <a name="g-drive-eject-with-operation-finish"></a><h3>g_drive_eject_with_operation_finish ()</h3>
1059 <pre class="programlisting"><a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
1060 g_drive_eject_with_operation_finish (<em class="parameter"><code><a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a> *drive</code></em>,
1061                                      <em class="parameter"><code><a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> *result</code></em>,
1062                                      <em class="parameter"><code><a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
1063 <p>Finishes ejecting a drive. If any errors occurred during the operation,
1064 <em class="parameter"><code>error</code></em>
1065  will be set to contain the errors and <a href="../glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> will be returned.</p>
1066 <div class="refsect3">
1067 <a name="g-drive-eject-with-operation-finish.parameters"></a><h4>Parameters</h4>
1068 <div class="informaltable"><table class="informaltable" width="100%" border="0">
1069 <colgroup>
1070 <col width="150px" class="parameters_name">
1071 <col class="parameters_description">
1072 <col width="200px" class="parameters_annotations">
1073 </colgroup>
1074 <tbody>
1075 <tr>
1076 <td class="parameter_name"><p>drive</p></td>
1077 <td class="parameter_description"><p>a <a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a>.</p></td>
1078 <td class="parameter_annotations"> </td>
1079 </tr>
1080 <tr>
1081 <td class="parameter_name"><p>result</p></td>
1082 <td class="parameter_description"><p>a <a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a>.</p></td>
1083 <td class="parameter_annotations"> </td>
1084 </tr>
1085 <tr>
1086 <td class="parameter_name"><p>error</p></td>
1087 <td class="parameter_description"><p>a <a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> location to store the error occurring, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to
1088 ignore.</p></td>
1089 <td class="parameter_annotations"> </td>
1090 </tr>
1091 </tbody>
1092 </table></div>
1093 </div>
1094 <div class="refsect3">
1095 <a name="g-drive-eject-with-operation-finish.returns"></a><h4>Returns</h4>
1096 <p> <a href="../glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the drive was successfully ejected. <a href="../glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</p>
1097 </div>
1098 <p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
1099 </div>
1100 <hr>
1101 <div class="refsect2">
1102 <a name="g-drive-start"></a><h3>g_drive_start ()</h3>
1103 <pre class="programlisting"><span class="returnvalue">void</span>
1104 g_drive_start (<em class="parameter"><code><a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a> *drive</code></em>,
1105                <em class="parameter"><code><a class="link" href="GDrive.html#GDriveStartFlags" title="enum GDriveStartFlags"><span class="type">GDriveStartFlags</span></a> flags</code></em>,
1106                <em class="parameter"><code><a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a> *mount_operation</code></em>,
1107                <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
1108                <em class="parameter"><code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
1109                <em class="parameter"><code><a href="../glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
1110 <p>Asynchronously starts a drive.</p>
1111 <p>When the operation is finished, <em class="parameter"><code>callback</code></em>
1112  will be called.
1113 You can then call <a class="link" href="GDrive.html#g-drive-start-finish" title="g_drive_start_finish ()"><code class="function">g_drive_start_finish()</code></a> to obtain the
1114 result of the operation.</p>
1115 <div class="refsect3">
1116 <a name="g-drive-start.parameters"></a><h4>Parameters</h4>
1117 <div class="informaltable"><table class="informaltable" width="100%" border="0">
1118 <colgroup>
1119 <col width="150px" class="parameters_name">
1120 <col class="parameters_description">
1121 <col width="200px" class="parameters_annotations">
1122 </colgroup>
1123 <tbody>
1124 <tr>
1125 <td class="parameter_name"><p>drive</p></td>
1126 <td class="parameter_description"><p>a <a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a>.</p></td>
1127 <td class="parameter_annotations"> </td>
1128 </tr>
1129 <tr>
1130 <td class="parameter_name"><p>flags</p></td>
1131 <td class="parameter_description"><p>flags affecting the start operation.</p></td>
1132 <td class="parameter_annotations"> </td>
1133 </tr>
1134 <tr>
1135 <td class="parameter_name"><p>mount_operation</p></td>
1136 <td class="parameter_description"><p> a <a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a> or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to avoid
1137 user interaction. </p></td>
1138 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
1139 </tr>
1140 <tr>
1141 <td class="parameter_name"><p>cancellable</p></td>
1142 <td class="parameter_description"><p> optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </p></td>
1143 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
1144 </tr>
1145 <tr>
1146 <td class="parameter_name"><p>callback</p></td>
1147 <td class="parameter_description"><p> a <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a>, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
1148 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
1149 </tr>
1150 <tr>
1151 <td class="parameter_name"><p>user_data</p></td>
1152 <td class="parameter_description"><p>user data to pass to <em class="parameter"><code>callback</code></em>
1153 </p></td>
1154 <td class="parameter_annotations"> </td>
1155 </tr>
1156 </tbody>
1157 </table></div>
1158 </div>
1159 <p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
1160 </div>
1161 <hr>
1162 <div class="refsect2">
1163 <a name="g-drive-start-finish"></a><h3>g_drive_start_finish ()</h3>
1164 <pre class="programlisting"><a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
1165 g_drive_start_finish (<em class="parameter"><code><a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a> *drive</code></em>,
1166                       <em class="parameter"><code><a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> *result</code></em>,
1167                       <em class="parameter"><code><a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
1168 <p>Finishes starting a drive.</p>
1169 <div class="refsect3">
1170 <a name="g-drive-start-finish.parameters"></a><h4>Parameters</h4>
1171 <div class="informaltable"><table class="informaltable" width="100%" border="0">
1172 <colgroup>
1173 <col width="150px" class="parameters_name">
1174 <col class="parameters_description">
1175 <col width="200px" class="parameters_annotations">
1176 </colgroup>
1177 <tbody>
1178 <tr>
1179 <td class="parameter_name"><p>drive</p></td>
1180 <td class="parameter_description"><p>a <a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a>.</p></td>
1181 <td class="parameter_annotations"> </td>
1182 </tr>
1183 <tr>
1184 <td class="parameter_name"><p>result</p></td>
1185 <td class="parameter_description"><p>a <a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a>.</p></td>
1186 <td class="parameter_annotations"> </td>
1187 </tr>
1188 <tr>
1189 <td class="parameter_name"><p>error</p></td>
1190 <td class="parameter_description"><p>a <a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
1191 <td class="parameter_annotations"> </td>
1192 </tr>
1193 </tbody>
1194 </table></div>
1195 </div>
1196 <div class="refsect3">
1197 <a name="g-drive-start-finish.returns"></a><h4>Returns</h4>
1198 <p> <a href="../glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the drive has been started successfully,
1199 <a href="../glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</p>
1200 </div>
1201 <p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
1202 </div>
1203 <hr>
1204 <div class="refsect2">
1205 <a name="g-drive-stop"></a><h3>g_drive_stop ()</h3>
1206 <pre class="programlisting"><span class="returnvalue">void</span>
1207 g_drive_stop (<em class="parameter"><code><a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a> *drive</code></em>,
1208               <em class="parameter"><code><a class="link" href="GMount.html#GMountUnmountFlags" title="enum GMountUnmountFlags"><span class="type">GMountUnmountFlags</span></a> flags</code></em>,
1209               <em class="parameter"><code><a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a> *mount_operation</code></em>,
1210               <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
1211               <em class="parameter"><code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
1212               <em class="parameter"><code><a href="../glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
1213 <p>Asynchronously stops a drive.</p>
1214 <p>When the operation is finished, <em class="parameter"><code>callback</code></em>
1215  will be called.
1216 You can then call <a class="link" href="GDrive.html#g-drive-stop-finish" title="g_drive_stop_finish ()"><code class="function">g_drive_stop_finish()</code></a> to obtain the
1217 result of the operation.</p>
1218 <div class="refsect3">
1219 <a name="g-drive-stop.parameters"></a><h4>Parameters</h4>
1220 <div class="informaltable"><table class="informaltable" width="100%" border="0">
1221 <colgroup>
1222 <col width="150px" class="parameters_name">
1223 <col class="parameters_description">
1224 <col width="200px" class="parameters_annotations">
1225 </colgroup>
1226 <tbody>
1227 <tr>
1228 <td class="parameter_name"><p>drive</p></td>
1229 <td class="parameter_description"><p>a <a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a>.</p></td>
1230 <td class="parameter_annotations"> </td>
1231 </tr>
1232 <tr>
1233 <td class="parameter_name"><p>flags</p></td>
1234 <td class="parameter_description"><p>flags affecting the unmount if required for stopping.</p></td>
1235 <td class="parameter_annotations"> </td>
1236 </tr>
1237 <tr>
1238 <td class="parameter_name"><p>mount_operation</p></td>
1239 <td class="parameter_description"><p> a <a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a> or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to avoid
1240 user interaction. </p></td>
1241 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
1242 </tr>
1243 <tr>
1244 <td class="parameter_name"><p>cancellable</p></td>
1245 <td class="parameter_description"><p> optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </p></td>
1246 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
1247 </tr>
1248 <tr>
1249 <td class="parameter_name"><p>callback</p></td>
1250 <td class="parameter_description"><p> a <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a>, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
1251 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
1252 </tr>
1253 <tr>
1254 <td class="parameter_name"><p>user_data</p></td>
1255 <td class="parameter_description"><p>user data to pass to <em class="parameter"><code>callback</code></em>
1256 </p></td>
1257 <td class="parameter_annotations"> </td>
1258 </tr>
1259 </tbody>
1260 </table></div>
1261 </div>
1262 <p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
1263 </div>
1264 <hr>
1265 <div class="refsect2">
1266 <a name="g-drive-stop-finish"></a><h3>g_drive_stop_finish ()</h3>
1267 <pre class="programlisting"><a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
1268 g_drive_stop_finish (<em class="parameter"><code><a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a> *drive</code></em>,
1269                      <em class="parameter"><code><a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> *result</code></em>,
1270                      <em class="parameter"><code><a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
1271 <p>Finishes stopping a drive.</p>
1272 <div class="refsect3">
1273 <a name="g-drive-stop-finish.parameters"></a><h4>Parameters</h4>
1274 <div class="informaltable"><table class="informaltable" width="100%" border="0">
1275 <colgroup>
1276 <col width="150px" class="parameters_name">
1277 <col class="parameters_description">
1278 <col width="200px" class="parameters_annotations">
1279 </colgroup>
1280 <tbody>
1281 <tr>
1282 <td class="parameter_name"><p>drive</p></td>
1283 <td class="parameter_description"><p>a <a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a>.</p></td>
1284 <td class="parameter_annotations"> </td>
1285 </tr>
1286 <tr>
1287 <td class="parameter_name"><p>result</p></td>
1288 <td class="parameter_description"><p>a <a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a>.</p></td>
1289 <td class="parameter_annotations"> </td>
1290 </tr>
1291 <tr>
1292 <td class="parameter_name"><p>error</p></td>
1293 <td class="parameter_description"><p>a <a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
1294 <td class="parameter_annotations"> </td>
1295 </tr>
1296 </tbody>
1297 </table></div>
1298 </div>
1299 <div class="refsect3">
1300 <a name="g-drive-stop-finish.returns"></a><h4>Returns</h4>
1301 <p> <a href="../glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the drive has been stopped successfully,
1302 <a href="../glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</p>
1303 </div>
1304 <p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
1305 </div>
1306 <hr>
1307 <div class="refsect2">
1308 <a name="g-drive-enumerate-identifiers"></a><h3>g_drive_enumerate_identifiers ()</h3>
1309 <pre class="programlisting"><span class="returnvalue">char</span> **
1310 g_drive_enumerate_identifiers (<em class="parameter"><code><a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a> *drive</code></em>);</pre>
1311 <p>Gets the kinds of identifiers that <em class="parameter"><code>drive</code></em>
1312  has.
1313 Use <a class="link" href="GDrive.html#g-drive-get-identifier" title="g_drive_get_identifier ()"><code class="function">g_drive_get_identifier()</code></a> to obtain the identifiers
1314 themselves.</p>
1315 <div class="refsect3">
1316 <a name="g-drive-enumerate-identifiers.parameters"></a><h4>Parameters</h4>
1317 <div class="informaltable"><table class="informaltable" width="100%" border="0">
1318 <colgroup>
1319 <col width="150px" class="parameters_name">
1320 <col class="parameters_description">
1321 <col width="200px" class="parameters_annotations">
1322 </colgroup>
1323 <tbody><tr>
1324 <td class="parameter_name"><p>drive</p></td>
1325 <td class="parameter_description"><p>a <a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a></p></td>
1326 <td class="parameter_annotations"> </td>
1327 </tr></tbody>
1328 </table></div>
1329 </div>
1330 <div class="refsect3">
1331 <a name="g-drive-enumerate-identifiers.returns"></a><h4>Returns</h4>
1332 <p> a <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated
1333 array of strings containing kinds of identifiers. Use <a href="../glib-String-Utility-Functions.html#g-strfreev"><code class="function">g_strfreev()</code></a>
1334 to free. </p>
1335 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>][<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> zero-terminated=1]</span></p>
1336 </div>
1337 </div>
1338 <hr>
1339 <div class="refsect2">
1340 <a name="g-drive-get-identifier"></a><h3>g_drive_get_identifier ()</h3>
1341 <pre class="programlisting"><span class="returnvalue">char</span> *
1342 g_drive_get_identifier (<em class="parameter"><code><a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a> *drive</code></em>,
1343                         <em class="parameter"><code>const <span class="type">char</span> *kind</code></em>);</pre>
1344 <p>Gets the identifier of the given kind for <em class="parameter"><code>drive</code></em>
1345 .</p>
1346 <div class="refsect3">
1347 <a name="g-drive-get-identifier.parameters"></a><h4>Parameters</h4>
1348 <div class="informaltable"><table class="informaltable" width="100%" border="0">
1349 <colgroup>
1350 <col width="150px" class="parameters_name">
1351 <col class="parameters_description">
1352 <col width="200px" class="parameters_annotations">
1353 </colgroup>
1354 <tbody>
1355 <tr>
1356 <td class="parameter_name"><p>drive</p></td>
1357 <td class="parameter_description"><p>a <a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a></p></td>
1358 <td class="parameter_annotations"> </td>
1359 </tr>
1360 <tr>
1361 <td class="parameter_name"><p>kind</p></td>
1362 <td class="parameter_description"><p>the kind of identifier to return</p></td>
1363 <td class="parameter_annotations"> </td>
1364 </tr>
1365 </tbody>
1366 </table></div>
1367 </div>
1368 <div class="refsect3">
1369 <a name="g-drive-get-identifier.returns"></a><h4>Returns</h4>
1370 <p> a newly allocated string containing the
1371 requested identfier, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the <a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a>
1372 doesn't have this kind of identifier.</p>
1373 </div>
1374 </div>
1375 <hr>
1376 <div class="refsect2">
1377 <a name="g-drive-get-sort-key"></a><h3>g_drive_get_sort_key ()</h3>
1378 <pre class="programlisting">const <a href="../glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
1379 g_drive_get_sort_key (<em class="parameter"><code><a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a> *drive</code></em>);</pre>
1380 <p>Gets the sort key for <em class="parameter"><code>drive</code></em>
1381 , if any.</p>
1382 <div class="refsect3">
1383 <a name="g-drive-get-sort-key.parameters"></a><h4>Parameters</h4>
1384 <div class="informaltable"><table class="informaltable" width="100%" border="0">
1385 <colgroup>
1386 <col width="150px" class="parameters_name">
1387 <col class="parameters_description">
1388 <col width="200px" class="parameters_annotations">
1389 </colgroup>
1390 <tbody><tr>
1391 <td class="parameter_name"><p>drive</p></td>
1392 <td class="parameter_description"><p>A <a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a>.</p></td>
1393 <td class="parameter_annotations"> </td>
1394 </tr></tbody>
1395 </table></div>
1396 </div>
1397 <div class="refsect3">
1398 <a name="g-drive-get-sort-key.returns"></a><h4>Returns</h4>
1399 <p> Sorting key for <em class="parameter"><code>drive</code></em>
1400 or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if no such key is available.</p>
1401 </div>
1402 <p class="since">Since: <a class="link" href="api-index-2-32.html#api-index-2.32">2.32</a></p>
1403 </div>
1404 </div>
1405 <div class="refsect1">
1406 <a name="GDrive.other_details"></a><h2>Types and Values</h2>
1407 <div class="refsect2">
1408 <a name="GDrive-struct"></a><h3>GDrive</h3>
1409 <pre class="programlisting">typedef struct _GDrive GDrive;</pre>
1410 <p>Opaque drive object.</p>
1411 </div>
1412 <hr>
1413 <div class="refsect2">
1414 <a name="GDriveIface"></a><h3>struct GDriveIface</h3>
1415 <pre class="programlisting">struct GDriveIface {
1416   GTypeInterface g_iface;
1417
1418   /* signals */
1419   void     (* changed)                  (GDrive              *drive);
1420   void     (* disconnected)             (GDrive              *drive);
1421   void     (* eject_button)             (GDrive              *drive);
1422
1423   /* Virtual Table */
1424   char *   (* get_name)                 (GDrive              *drive);
1425   GIcon *  (* get_icon)                 (GDrive              *drive);
1426   gboolean (* has_volumes)              (GDrive              *drive);
1427   GList *  (* get_volumes)              (GDrive              *drive);
1428   gboolean (* is_media_removable)       (GDrive              *drive);
1429   gboolean (* has_media)                (GDrive              *drive);
1430   gboolean (* is_media_check_automatic) (GDrive              *drive);
1431   gboolean (* can_eject)                (GDrive              *drive);
1432   gboolean (* can_poll_for_media)       (GDrive              *drive);
1433   void     (* eject)                    (GDrive              *drive,
1434                                          GMountUnmountFlags   flags,
1435                                          GCancellable        *cancellable,
1436                                          GAsyncReadyCallback  callback,
1437                                          gpointer             user_data);
1438   gboolean (* eject_finish)             (GDrive              *drive,
1439                                          GAsyncResult        *result,
1440                                          GError             **error);
1441   void     (* poll_for_media)           (GDrive              *drive,
1442                                          GCancellable        *cancellable,
1443                                          GAsyncReadyCallback  callback,
1444                                          gpointer             user_data);
1445   gboolean (* poll_for_media_finish)    (GDrive              *drive,
1446                                          GAsyncResult        *result,
1447                                          GError             **error);
1448
1449   char *   (* get_identifier)           (GDrive              *drive,
1450                                          const char          *kind);
1451   char **  (* enumerate_identifiers)    (GDrive              *drive);
1452
1453   GDriveStartStopType (* get_start_stop_type) (GDrive        *drive);
1454
1455   gboolean (* can_start)                (GDrive              *drive);
1456   gboolean (* can_start_degraded)       (GDrive              *drive);
1457   void     (* start)                    (GDrive              *drive,
1458                                          GDriveStartFlags     flags,
1459                                          GMountOperation     *mount_operation,
1460                                          GCancellable        *cancellable,
1461                                          GAsyncReadyCallback  callback,
1462                                          gpointer             user_data);
1463   gboolean (* start_finish)             (GDrive              *drive,
1464                                          GAsyncResult        *result,
1465                                          GError             **error);
1466
1467   gboolean (* can_stop)                 (GDrive              *drive);
1468   void     (* stop)                     (GDrive              *drive,
1469                                          GMountUnmountFlags   flags,
1470                                          GMountOperation     *mount_operation,
1471                                          GCancellable        *cancellable,
1472                                          GAsyncReadyCallback  callback,
1473                                          gpointer             user_data);
1474   gboolean (* stop_finish)              (GDrive              *drive,
1475                                          GAsyncResult        *result,
1476                                          GError             **error);
1477   /* signal, not VFunc */
1478   void     (* stop_button)              (GDrive              *drive);
1479
1480   void        (* eject_with_operation)      (GDrive              *drive,
1481                                              GMountUnmountFlags   flags,
1482                                              GMountOperation     *mount_operation,
1483                                              GCancellable        *cancellable,
1484                                              GAsyncReadyCallback  callback,
1485                                              gpointer             user_data);
1486   gboolean    (* eject_with_operation_finish) (GDrive            *drive,
1487                                              GAsyncResult        *result,
1488                                              GError             **error);
1489
1490   const gchar * (* get_sort_key)        (GDrive              *drive);
1491   GIcon *       (* get_symbolic_icon)   (GDrive              *drive);
1492   gboolean      (* is_removable)        (GDrive              *drive);
1493 };
1494 </pre>
1495 <p>Interface for creating <a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a> implementations.</p>
1496 <div class="refsect3">
1497 <a name="GDriveIface.members"></a><h4>Members</h4>
1498 <div class="informaltable"><table class="informaltable" width="100%" border="0">
1499 <colgroup>
1500 <col width="300px" class="struct_members_name">
1501 <col class="struct_members_description">
1502 <col width="200px" class="struct_members_annotations">
1503 </colgroup>
1504 <tbody>
1505 <tr>
1506 <td class="struct_member_name"><p><em class="structfield"><code><a name="GDriveIface.changed"></a>changed</code></em> ()</p></td>
1507 <td class="struct_member_description"><p>Signal emitted when the drive is changed.</p></td>
1508 <td class="struct_member_annotations"> </td>
1509 </tr>
1510 <tr>
1511 <td class="struct_member_name"><p><em class="structfield"><code><a name="GDriveIface.disconnected"></a>disconnected</code></em> ()</p></td>
1512 <td class="struct_member_description"><p>The removed signal that is emitted when the <a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a> have been disconnected. If the recipient is holding references to the object they should release them so the object can be finalized.</p></td>
1513 <td class="struct_member_annotations"> </td>
1514 </tr>
1515 <tr>
1516 <td class="struct_member_name"><p><em class="structfield"><code><a name="GDriveIface.eject-button"></a>eject_button</code></em> ()</p></td>
1517 <td class="struct_member_description"><p>Signal emitted when the physical eject button (if any) of a drive have been pressed.</p></td>
1518 <td class="struct_member_annotations"> </td>
1519 </tr>
1520 <tr>
1521 <td class="struct_member_name"><p><em class="structfield"><code><a name="GDriveIface.get-name"></a>get_name</code></em> ()</p></td>
1522 <td class="struct_member_description"><p>Returns the name for the given <a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a>.</p></td>
1523 <td class="struct_member_annotations"> </td>
1524 </tr>
1525 <tr>
1526 <td class="struct_member_name"><p><em class="structfield"><code><a name="GDriveIface.get-icon"></a>get_icon</code></em> ()</p></td>
1527 <td class="struct_member_description"><p>Returns a <a class="link" href="GIcon.html" title="GIcon"><span class="type">GIcon</span></a> for the given <a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a>.</p></td>
1528 <td class="struct_member_annotations"> </td>
1529 </tr>
1530 <tr>
1531 <td class="struct_member_name"><p><em class="structfield"><code><a name="GDriveIface.has-volumes"></a>has_volumes</code></em> ()</p></td>
1532 <td class="struct_member_description"><p>Returns <a href="../glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the <a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a> has mountable volumes.</p></td>
1533 <td class="struct_member_annotations"> </td>
1534 </tr>
1535 <tr>
1536 <td class="struct_member_name"><p><em class="structfield"><code><a name="GDriveIface.get-volumes"></a>get_volumes</code></em> ()</p></td>
1537 <td class="struct_member_description"><p>Returns a list <a href="../glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> of <a class="link" href="GVolume.html" title="GVolume"><span class="type">GVolume</span></a> for the <a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a>.</p></td>
1538 <td class="struct_member_annotations"> </td>
1539 </tr>
1540 <tr>
1541 <td class="struct_member_name"><p><em class="structfield"><code><a name="GDriveIface.is-media-removable"></a>is_media_removable</code></em> ()</p></td>
1542 <td class="struct_member_description"><p>Returns <a href="../glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the <a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a> supports removal and insertion of media.</p></td>
1543 <td class="struct_member_annotations"> </td>
1544 </tr>
1545 <tr>
1546 <td class="struct_member_name"><p><em class="structfield"><code><a name="GDriveIface.has-media"></a>has_media</code></em> ()</p></td>
1547 <td class="struct_member_description"><p>Returns <a href="../glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the <a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a> has media inserted.</p></td>
1548 <td class="struct_member_annotations"> </td>
1549 </tr>
1550 <tr>
1551 <td class="struct_member_name"><p><em class="structfield"><code><a name="GDriveIface.is-media-check-automatic"></a>is_media_check_automatic</code></em> ()</p></td>
1552 <td class="struct_member_description"><p>Returns <a href="../glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the <a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a> is capabable of automatically detecting media changes.</p></td>
1553 <td class="struct_member_annotations"> </td>
1554 </tr>
1555 <tr>
1556 <td class="struct_member_name"><p><em class="structfield"><code><a name="GDriveIface.can-eject"></a>can_eject</code></em> ()</p></td>
1557 <td class="struct_member_description"><p>Returns <a href="../glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the <a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a> can eject media.</p></td>
1558 <td class="struct_member_annotations"> </td>
1559 </tr>
1560 <tr>
1561 <td class="struct_member_name"><p><em class="structfield"><code><a name="GDriveIface.can-poll-for-media"></a>can_poll_for_media</code></em> ()</p></td>
1562 <td class="struct_member_description"><p>Returns <a href="../glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the <a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a> is capable of manually polling for media change.</p></td>
1563 <td class="struct_member_annotations"> </td>
1564 </tr>
1565 <tr>
1566 <td class="struct_member_name"><p><em class="structfield"><code><a name="GDriveIface.eject"></a>eject</code></em> ()</p></td>
1567 <td class="struct_member_description"><p>Ejects a <a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a>.</p></td>
1568 <td class="struct_member_annotations"> </td>
1569 </tr>
1570 <tr>
1571 <td class="struct_member_name"><p><em class="structfield"><code><a name="GDriveIface.eject-finish"></a>eject_finish</code></em> ()</p></td>
1572 <td class="struct_member_description"><p>Finishes an eject operation.</p></td>
1573 <td class="struct_member_annotations"> </td>
1574 </tr>
1575 <tr>
1576 <td class="struct_member_name"><p><em class="structfield"><code><a name="GDriveIface.poll-for-media"></a>poll_for_media</code></em> ()</p></td>
1577 <td class="struct_member_description"><p>Poll for media insertion/removal on a <a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a>.</p></td>
1578 <td class="struct_member_annotations"> </td>
1579 </tr>
1580 <tr>
1581 <td class="struct_member_name"><p><em class="structfield"><code><a name="GDriveIface.poll-for-media-finish"></a>poll_for_media_finish</code></em> ()</p></td>
1582 <td class="struct_member_description"><p>Finishes a media poll operation.</p></td>
1583 <td class="struct_member_annotations"> </td>
1584 </tr>
1585 <tr>
1586 <td class="struct_member_name"><p><em class="structfield"><code><a name="GDriveIface.get-identifier"></a>get_identifier</code></em> ()</p></td>
1587 <td class="struct_member_description"><p>Returns the identifier of the given kind, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if
1588 the <a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a> doesn't have one.</p></td>
1589 <td class="struct_member_annotations"> </td>
1590 </tr>
1591 <tr>
1592 <td class="struct_member_name"><p><em class="structfield"><code><a name="GDriveIface.enumerate-identifiers"></a>enumerate_identifiers</code></em> ()</p></td>
1593 <td class="struct_member_description"><p>Returns an array strings listing the kinds
1594 of identifiers which the <a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a> has.</p></td>
1595 <td class="struct_member_annotations"> </td>
1596 </tr>
1597 <tr>
1598 <td class="struct_member_name"><p><em class="structfield"><code><a name="GDriveIface.get-start-stop-type"></a>get_start_stop_type</code></em> ()</p></td>
1599 <td class="struct_member_description"><p>Gets a <a class="link" href="GDrive.html#GDriveStartStopType" title="enum GDriveStartStopType"><span class="type">GDriveStartStopType</span></a> with details about starting/stopping the drive. Since 2.22.</p></td>
1600 <td class="struct_member_annotations"> </td>
1601 </tr>
1602 <tr>
1603 <td class="struct_member_name"><p><em class="structfield"><code><a name="GDriveIface.can-start"></a>can_start</code></em> ()</p></td>
1604 <td class="struct_member_description"><p>Returns <a href="../glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if a <a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a> can be started. Since 2.22.</p></td>
1605 <td class="struct_member_annotations"> </td>
1606 </tr>
1607 <tr>
1608 <td class="struct_member_name"><p><em class="structfield"><code><a name="GDriveIface.can-start-degraded"></a>can_start_degraded</code></em> ()</p></td>
1609 <td class="struct_member_description"><p>Returns <a href="../glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if a <a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a> can be started degraded. Since 2.22.</p></td>
1610 <td class="struct_member_annotations"> </td>
1611 </tr>
1612 <tr>
1613 <td class="struct_member_name"><p><em class="structfield"><code><a name="GDriveIface.start"></a>start</code></em> ()</p></td>
1614 <td class="struct_member_description"><p>Starts a <a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a>. Since 2.22.</p></td>
1615 <td class="struct_member_annotations"> </td>
1616 </tr>
1617 <tr>
1618 <td class="struct_member_name"><p><em class="structfield"><code><a name="GDriveIface.start-finish"></a>start_finish</code></em> ()</p></td>
1619 <td class="struct_member_description"><p>Finishes a start operation. Since 2.22.</p></td>
1620 <td class="struct_member_annotations"> </td>
1621 </tr>
1622 <tr>
1623 <td class="struct_member_name"><p><em class="structfield"><code><a name="GDriveIface.can-stop"></a>can_stop</code></em> ()</p></td>
1624 <td class="struct_member_description"><p>Returns <a href="../glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if a <a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a> can be stopped. Since 2.22.</p></td>
1625 <td class="struct_member_annotations"> </td>
1626 </tr>
1627 <tr>
1628 <td class="struct_member_name"><p><em class="structfield"><code><a name="GDriveIface.stop"></a>stop</code></em> ()</p></td>
1629 <td class="struct_member_description"><p>Stops a <a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a>. Since 2.22.</p></td>
1630 <td class="struct_member_annotations"> </td>
1631 </tr>
1632 <tr>
1633 <td class="struct_member_name"><p><em class="structfield"><code><a name="GDriveIface.stop-finish"></a>stop_finish</code></em> ()</p></td>
1634 <td class="struct_member_description"><p>Finishes a stop operation. Since 2.22.</p></td>
1635 <td class="struct_member_annotations"> </td>
1636 </tr>
1637 <tr>
1638 <td class="struct_member_name"><p><em class="structfield"><code><a name="GDriveIface.stop-button"></a>stop_button</code></em> ()</p></td>
1639 <td class="struct_member_description"><p>Signal emitted when the physical stop button (if any) of a drive have been pressed. Since 2.22.</p></td>
1640 <td class="struct_member_annotations"> </td>
1641 </tr>
1642 <tr>
1643 <td class="struct_member_name"><p><em class="structfield"><code><a name="GDriveIface.eject-with-operation"></a>eject_with_operation</code></em> ()</p></td>
1644 <td class="struct_member_description"><p>Starts ejecting a <a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a> using a <a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a>. Since 2.22.</p></td>
1645 <td class="struct_member_annotations"> </td>
1646 </tr>
1647 <tr>
1648 <td class="struct_member_name"><p><em class="structfield"><code><a name="GDriveIface.eject-with-operation-finish"></a>eject_with_operation_finish</code></em> ()</p></td>
1649 <td class="struct_member_description"><p>Finishes an eject operation using a <a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a>. Since 2.22.</p></td>
1650 <td class="struct_member_annotations"> </td>
1651 </tr>
1652 <tr>
1653 <td class="struct_member_name"><p><em class="structfield"><code><a name="GDriveIface.get-sort-key"></a>get_sort_key</code></em> ()</p></td>
1654 <td class="struct_member_description"><p>Gets a key used for sorting <a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a> instances or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if no such key exists. Since 2.32.</p></td>
1655 <td class="struct_member_annotations"> </td>
1656 </tr>
1657 <tr>
1658 <td class="struct_member_name"><p><em class="structfield"><code><a name="GDriveIface.get-symbolic-icon"></a>get_symbolic_icon</code></em> ()</p></td>
1659 <td class="struct_member_description"><p>Returns a symbolic <a class="link" href="GIcon.html" title="GIcon"><span class="type">GIcon</span></a> for the given <a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a>. Since 2.34.</p></td>
1660 <td class="struct_member_annotations"> </td>
1661 </tr>
1662 <tr>
1663 <td class="struct_member_name"><p><em class="structfield"><code><a name="GDriveIface.is-removable"></a>is_removable</code></em> ()</p></td>
1664 <td class="struct_member_description"><p>Returns <a href="../glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the <a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a> and/or its media is considered removable by the user. Since 2.50.</p></td>
1665 <td class="struct_member_annotations"> </td>
1666 </tr>
1667 </tbody>
1668 </table></div>
1669 </div>
1670 </div>
1671 <hr>
1672 <div class="refsect2">
1673 <a name="GDriveStartFlags"></a><h3>enum GDriveStartFlags</h3>
1674 <p>Flags used when starting a drive.</p>
1675 <div class="refsect3">
1676 <a name="GDriveStartFlags.members"></a><h4>Members</h4>
1677 <div class="informaltable"><table class="informaltable" width="100%" border="0">
1678 <colgroup>
1679 <col width="300px" class="enum_members_name">
1680 <col class="enum_members_description">
1681 <col width="200px" class="enum_members_annotations">
1682 </colgroup>
1683 <tbody><tr>
1684 <td class="enum_member_name"><p><a name="G-DRIVE-START-NONE:CAPS"></a>G_DRIVE_START_NONE</p></td>
1685 <td class="enum_member_description">
1686 <p>No flags set.</p>
1687 </td>
1688 <td class="enum_member_annotations"> </td>
1689 </tr></tbody>
1690 </table></div>
1691 </div>
1692 <p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
1693 </div>
1694 <hr>
1695 <div class="refsect2">
1696 <a name="GDriveStartStopType"></a><h3>enum GDriveStartStopType</h3>
1697 <p>Enumeration describing how a drive can be started/stopped.</p>
1698 <div class="refsect3">
1699 <a name="GDriveStartStopType.members"></a><h4>Members</h4>
1700 <div class="informaltable"><table class="informaltable" width="100%" border="0">
1701 <colgroup>
1702 <col width="300px" class="enum_members_name">
1703 <col class="enum_members_description">
1704 <col width="200px" class="enum_members_annotations">
1705 </colgroup>
1706 <tbody>
1707 <tr>
1708 <td class="enum_member_name"><p><a name="G-DRIVE-START-STOP-TYPE-UNKNOWN:CAPS"></a>G_DRIVE_START_STOP_TYPE_UNKNOWN</p></td>
1709 <td class="enum_member_description">
1710 <p>Unknown or drive doesn't support
1711    start/stop.</p>
1712 </td>
1713 <td class="enum_member_annotations"> </td>
1714 </tr>
1715 <tr>
1716 <td class="enum_member_name"><p><a name="G-DRIVE-START-STOP-TYPE-SHUTDOWN:CAPS"></a>G_DRIVE_START_STOP_TYPE_SHUTDOWN</p></td>
1717 <td class="enum_member_description">
1718 <p>The stop method will physically
1719    shut down the drive and e.g. power down the port the drive is
1720    attached to.</p>
1721 </td>
1722 <td class="enum_member_annotations"> </td>
1723 </tr>
1724 <tr>
1725 <td class="enum_member_name"><p><a name="G-DRIVE-START-STOP-TYPE-NETWORK:CAPS"></a>G_DRIVE_START_STOP_TYPE_NETWORK</p></td>
1726 <td class="enum_member_description">
1727 <p>The start/stop methods are used
1728    for connecting/disconnect to the drive over the network.</p>
1729 </td>
1730 <td class="enum_member_annotations"> </td>
1731 </tr>
1732 <tr>
1733 <td class="enum_member_name"><p><a name="G-DRIVE-START-STOP-TYPE-MULTIDISK:CAPS"></a>G_DRIVE_START_STOP_TYPE_MULTIDISK</p></td>
1734 <td class="enum_member_description">
1735 <p>The start/stop methods will
1736    assemble/disassemble a virtual drive from several physical
1737    drives.</p>
1738 </td>
1739 <td class="enum_member_annotations"> </td>
1740 </tr>
1741 <tr>
1742 <td class="enum_member_name"><p><a name="G-DRIVE-START-STOP-TYPE-PASSWORD:CAPS"></a>G_DRIVE_START_STOP_TYPE_PASSWORD</p></td>
1743 <td class="enum_member_description">
1744 <p>The start/stop methods will
1745    unlock/lock the disk (for example using the ATA &lt;quote&gt;SECURITY
1746    UNLOCK DEVICE&lt;/quote&gt; command)</p>
1747 </td>
1748 <td class="enum_member_annotations"> </td>
1749 </tr>
1750 </tbody>
1751 </table></div>
1752 </div>
1753 <p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
1754 </div>
1755 </div>
1756 <div class="refsect1">
1757 <a name="GDrive.signal-details"></a><h2>Signal Details</h2>
1758 <div class="refsect2">
1759 <a name="GDrive-changed"></a><h3>The <code class="literal">“changed”</code> signal</h3>
1760 <pre class="programlisting"><span class="returnvalue">void</span>
1761 user_function (<a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a>  *drive,
1762                <a href="../glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre>
1763 <p>Emitted when the drive's state has changed.</p>
1764 <div class="refsect3">
1765 <a name="GDrive-changed.parameters"></a><h4>Parameters</h4>
1766 <div class="informaltable"><table class="informaltable" width="100%" border="0">
1767 <colgroup>
1768 <col width="150px" class="parameters_name">
1769 <col class="parameters_description">
1770 <col width="200px" class="parameters_annotations">
1771 </colgroup>
1772 <tbody>
1773 <tr>
1774 <td class="parameter_name"><p>drive</p></td>
1775 <td class="parameter_description"><p>a <a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a>.</p></td>
1776 <td class="parameter_annotations"> </td>
1777 </tr>
1778 <tr>
1779 <td class="parameter_name"><p>user_data</p></td>
1780 <td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
1781 <td class="parameter_annotations"> </td>
1782 </tr>
1783 </tbody>
1784 </table></div>
1785 </div>
1786 <p>Flags: <a href="../gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></p>
1787 </div>
1788 <hr>
1789 <div class="refsect2">
1790 <a name="GDrive-disconnected"></a><h3>The <code class="literal">“disconnected”</code> signal</h3>
1791 <pre class="programlisting"><span class="returnvalue">void</span>
1792 user_function (<a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a>  *drive,
1793                <a href="../glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre>
1794 <p>This signal is emitted when the <a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a> have been
1795 disconnected. If the recipient is holding references to the
1796 object they should release them so the object can be
1797 finalized.</p>
1798 <div class="refsect3">
1799 <a name="GDrive-disconnected.parameters"></a><h4>Parameters</h4>
1800 <div class="informaltable"><table class="informaltable" width="100%" border="0">
1801 <colgroup>
1802 <col width="150px" class="parameters_name">
1803 <col class="parameters_description">
1804 <col width="200px" class="parameters_annotations">
1805 </colgroup>
1806 <tbody>
1807 <tr>
1808 <td class="parameter_name"><p>drive</p></td>
1809 <td class="parameter_description"><p>a <a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a>.</p></td>
1810 <td class="parameter_annotations"> </td>
1811 </tr>
1812 <tr>
1813 <td class="parameter_name"><p>user_data</p></td>
1814 <td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
1815 <td class="parameter_annotations"> </td>
1816 </tr>
1817 </tbody>
1818 </table></div>
1819 </div>
1820 <p>Flags: <a href="../gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></p>
1821 </div>
1822 <hr>
1823 <div class="refsect2">
1824 <a name="GDrive-eject-button"></a><h3>The <code class="literal">“eject-button”</code> signal</h3>
1825 <pre class="programlisting"><span class="returnvalue">void</span>
1826 user_function (<a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a>  *drive,
1827                <a href="../glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre>
1828 <p>Emitted when the physical eject button (if any) of a drive has
1829 been pressed.</p>
1830 <div class="refsect3">
1831 <a name="GDrive-eject-button.parameters"></a><h4>Parameters</h4>
1832 <div class="informaltable"><table class="informaltable" width="100%" border="0">
1833 <colgroup>
1834 <col width="150px" class="parameters_name">
1835 <col class="parameters_description">
1836 <col width="200px" class="parameters_annotations">
1837 </colgroup>
1838 <tbody>
1839 <tr>
1840 <td class="parameter_name"><p>drive</p></td>
1841 <td class="parameter_description"><p>a <a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a>.</p></td>
1842 <td class="parameter_annotations"> </td>
1843 </tr>
1844 <tr>
1845 <td class="parameter_name"><p>user_data</p></td>
1846 <td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
1847 <td class="parameter_annotations"> </td>
1848 </tr>
1849 </tbody>
1850 </table></div>
1851 </div>
1852 <p>Flags: <a href="../gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></p>
1853 </div>
1854 <hr>
1855 <div class="refsect2">
1856 <a name="GDrive-stop-button"></a><h3>The <code class="literal">“stop-button”</code> signal</h3>
1857 <pre class="programlisting"><span class="returnvalue">void</span>
1858 user_function (<a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a>  *drive,
1859                <a href="../glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre>
1860 <p>Emitted when the physical stop button (if any) of a drive has
1861 been pressed.</p>
1862 <div class="refsect3">
1863 <a name="GDrive-stop-button.parameters"></a><h4>Parameters</h4>
1864 <div class="informaltable"><table class="informaltable" width="100%" border="0">
1865 <colgroup>
1866 <col width="150px" class="parameters_name">
1867 <col class="parameters_description">
1868 <col width="200px" class="parameters_annotations">
1869 </colgroup>
1870 <tbody>
1871 <tr>
1872 <td class="parameter_name"><p>drive</p></td>
1873 <td class="parameter_description"><p>a <a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a>.</p></td>
1874 <td class="parameter_annotations"> </td>
1875 </tr>
1876 <tr>
1877 <td class="parameter_name"><p>user_data</p></td>
1878 <td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
1879 <td class="parameter_annotations"> </td>
1880 </tr>
1881 </tbody>
1882 </table></div>
1883 </div>
1884 <p>Flags: <a href="../gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></p>
1885 <p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
1886 </div>
1887 </div>
1888 </div>
1889 <div class="footer">
1890 <hr>Generated by GTK-Doc V1.25.1</div>
1891 </body>
1892 </html>