Commit d5154874 authored by Sebastian Dröge's avatar Sebastian Dröge
Browse files

gio: Add documentation for the new "not-mounted" and "file-exists" messages

parent b9c79380
......@@ -27,6 +27,18 @@
* by an URI. This location can be specified using any protocol supported by
* the GIO library or it's VFS backends. Common protocols are 'file', 'ftp',
* or 'smb'.
*
* If the URI or #GFile already exists giosink will post a message of
* type %GST_MESSAGE_ELEMENT with name "file-exists" on the bus. The message
* also contains the #GFile and the corresponding URI.
* Applications can use the "file-exists" message to notify the user about
* the problem and to set a different target location or to remove the
* existing file. Note that right after the "file-exists" message a normal
* error message is posted on the bus which should be ignored if "file-exists"
* is handled by the application, for example by calling
* gst_bus_set_flushing(bus, TRUE) after the "file-exists" message was
* received and gst_bus_set_flushing(bus, FALSE) after the problem is
* resolved.
*
* <refsect2>
* <title>Example pipelines</title>
......
......@@ -28,6 +28,18 @@
* the GIO library or it's VFS backends. Common protocols are 'file', 'http',
* 'ftp', or 'smb'.
*
* If an URI or #GFile is not mounted giosrc will post a message of type
* %GST_MESSAGE_ELEMENT with name "not-mounted" on the bus. The message
* also contains the #GFile and the corresponding URI.
* Applications can use the "not-mounted" message to mount the #GFile
* by calling g_file_mount_enclosing_volume() and then restart the
* pipeline after the mounting has succeeded. Note that right after the
* "not-mounted" message a normal error message is posted on the bus which
* should be ignored if "not-mounted" is handled by the application, for
* example by calling gst_bus_set_flushing(bus, TRUE) after the "not-mounted"
* message was received and gst_bus_set_flushing(bus, FALSE) after the
* mounting was successful.
*
* <refsect2>
* <title>Example launch lines</title>
* |[
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment