← Back to branch summary

~mfisch/brasero/update-to-3.8.0

« back to all changes in this revision

Viewing changes to docs/reference/libbrasero-media/xml/brasero-medium.xml

  • Committer: Bazaar Package Importer
  • Author(s): Andreas Moog
  • Date: 2009-07-28 01:12:27 UTC
  • mto: (1.4.1 experimental)
  • mto: This revision was merged to the branch mainline in revision 46.
  • Revision ID: james.westby@ubuntu.com-20090728011227-tiva9yorc5d1r5hs
Tags: upstream-2.27.5
Import upstream version 2.27.5

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/reference/libbrasero-media/xml/brasero-medium.xml
1
 
<refentry id="libbrasero-media-BraseroMedium">
2
 
<refmeta>
3
 
<refentrytitle role="top_of_page" id="libbrasero-media-BraseroMedium.top_of_page">BraseroMedium</refentrytitle>
4
 
<manvolnum>3</manvolnum>
5
 
<refmiscinfo>LIBBRASERO-MEDIA Library</refmiscinfo>
6
 
</refmeta>
7
 
 
8
 
<refnamediv>
9
 
<refname>BraseroMedium</refname>
10
 
<refpurpose></refpurpose>
11
 
</refnamediv>
12
 
 
13
 
<refsynopsisdiv id="libbrasero-media-BraseroMedium.synopsis" role="synopsis">
14
 
<title role="synopsis.title">Synopsis</title>
15
 
 
16
 
<synopsis>
17
 
                    <link linkend="BraseroMedium">BraseroMedium</link>;
18
 
<link linkend="BraseroMedia">BraseroMedia</link>        <link linkend="brasero-medium-get-status">brasero_medium_get_status</link>           (<link linkend="BraseroMedium">BraseroMedium</link> *medium);
19
 
<link linkend="guint64">guint64</link>             <link linkend="brasero-medium-get-max-write-speed">brasero_medium_get_max_write_speed</link>  (<link linkend="BraseroMedium">BraseroMedium</link> *medium);
20
 
<link linkend="guint64">guint64</link> *           <link linkend="brasero-medium-get-write-speeds">brasero_medium_get_write_speeds</link>     (<link linkend="BraseroMedium">BraseroMedium</link> *medium);
21
 
<link linkend="void">void</link>                <link linkend="brasero-medium-get-free-space">brasero_medium_get_free_space</link>       (<link linkend="BraseroMedium">BraseroMedium</link> *medium,
22
 
                                                         <link linkend="goffset">goffset</link> *bytes,
23
 
                                                         <link linkend="goffset">goffset</link> *blocks);
24
 
<link linkend="void">void</link>                <link linkend="brasero-medium-get-capacity">brasero_medium_get_capacity</link>         (<link linkend="BraseroMedium">BraseroMedium</link> *medium,
25
 
                                                         <link linkend="goffset">goffset</link> *bytes,
26
 
                                                         <link linkend="goffset">goffset</link> *blocks);
27
 
<link linkend="void">void</link>                <link linkend="brasero-medium-get-data-size">brasero_medium_get_data_size</link>        (<link linkend="BraseroMedium">BraseroMedium</link> *medium,
28
 
                                                         <link linkend="goffset">goffset</link> *bytes,
29
 
                                                         <link linkend="goffset">goffset</link> *blocks);
30
 
<link linkend="gint64">gint64</link>              <link linkend="brasero-medium-get-next-writable-address">brasero_medium_get_next_writable_address</link>
31
 
                                                        (<link linkend="BraseroMedium">BraseroMedium</link> *medium);
32
 
<link linkend="gboolean">gboolean</link>            <link linkend="brasero-medium-can-be-rewritten">brasero_medium_can_be_rewritten</link>     (<link linkend="BraseroMedium">BraseroMedium</link> *medium);
33
 
<link linkend="gboolean">gboolean</link>            <link linkend="brasero-medium-can-be-written">brasero_medium_can_be_written</link>       (<link linkend="BraseroMedium">BraseroMedium</link> *medium);
34
 
const <link linkend="gchar">gchar</link> *       <link linkend="brasero-medium-get-CD-TEXT-title">brasero_medium_get_CD_TEXT_title</link>    (<link linkend="BraseroMedium">BraseroMedium</link> *medium);
35
 
const <link linkend="gchar">gchar</link> *       <link linkend="brasero-medium-get-type-string">brasero_medium_get_type_string</link>      (<link linkend="BraseroMedium">BraseroMedium</link> *medium);
36
 
<link linkend="gchar">gchar</link> *             <link linkend="brasero-medium-get-tooltip">brasero_medium_get_tooltip</link>          (<link linkend="BraseroMedium">BraseroMedium</link> *medium);
37
 
<link linkend="BraseroDrive">BraseroDrive</link> *      <link linkend="brasero-medium-get-drive">brasero_medium_get_drive</link>            (<link linkend="BraseroMedium">BraseroMedium</link> *medium);
38
 
<link linkend="guint">guint</link>               <link linkend="brasero-medium-get-track-num">brasero_medium_get_track_num</link>        (<link linkend="BraseroMedium">BraseroMedium</link> *medium);
39
 
<link linkend="gboolean">gboolean</link>            <link linkend="brasero-medium-get-last-data-track-space">brasero_medium_get_last_data_track_space</link>
40
 
                                                        (<link linkend="BraseroMedium">BraseroMedium</link> *medium,
41
 
                                                         <link linkend="goffset">goffset</link> *bytes,
42
 
                                                         <link linkend="goffset">goffset</link> *sectors);
43
 
<link linkend="gboolean">gboolean</link>            <link linkend="brasero-medium-get-last-data-track-address">brasero_medium_get_last_data_track_address</link>
44
 
                                                        (<link linkend="BraseroMedium">BraseroMedium</link> *medium,
45
 
                                                         <link linkend="goffset">goffset</link> *bytes,
46
 
                                                         <link linkend="goffset">goffset</link> *sectors);
47
 
<link linkend="gboolean">gboolean</link>            <link linkend="brasero-medium-get-track-space">brasero_medium_get_track_space</link>      (<link linkend="BraseroMedium">BraseroMedium</link> *medium,
48
 
                                                         <link linkend="guint">guint</link> num,
49
 
                                                         <link linkend="goffset">goffset</link> *bytes,
50
 
                                                         <link linkend="goffset">goffset</link> *sectors);
51
 
<link linkend="gboolean">gboolean</link>            <link linkend="brasero-medium-get-track-address">brasero_medium_get_track_address</link>    (<link linkend="BraseroMedium">BraseroMedium</link> *medium,
52
 
                                                         <link linkend="guint">guint</link> num,
53
 
                                                         <link linkend="goffset">goffset</link> *bytes,
54
 
                                                         <link linkend="goffset">goffset</link> *sectors);
55
 
<link linkend="gboolean">gboolean</link>            <link linkend="brasero-medium-can-use-dummy-for-sao">brasero_medium_can_use_dummy_for_sao</link>
56
 
                                                        (<link linkend="BraseroMedium">BraseroMedium</link> *medium);
57
 
<link linkend="gboolean">gboolean</link>            <link linkend="brasero-medium-can-use-dummy-for-tao">brasero_medium_can_use_dummy_for_tao</link>
58
 
                                                        (<link linkend="BraseroMedium">BraseroMedium</link> *medium);
59
 
<link linkend="gboolean">gboolean</link>            <link linkend="brasero-medium-can-use-burnfree">brasero_medium_can_use_burnfree</link>     (<link linkend="BraseroMedium">BraseroMedium</link> *medium);
60
 
</synopsis>
61
 
</refsynopsisdiv>
62
 
 
63
 
 
64
 
 
65
 
 
66
 
 
67
 
 
68
 
 
69
 
 
70
 
 
71
 
<refsect1 id="libbrasero-media-BraseroMedium.description" role="desc">
72
 
<title role="desc.title">Description</title>
73
 
<para>
74
 
</para>
75
 
</refsect1>
76
 
 
77
 
<refsect1 id="libbrasero-media-BraseroMedium.details" role="details">
78
 
<title role="details.title">Details</title>
79
 
<refsect2 id="BraseroMedium" role="struct">
80
 
<title>BraseroMedium</title>
81
 
<indexterm zone="BraseroMedium"><primary sortas="BraseroMedium">BraseroMedium</primary></indexterm><programlisting>typedef struct {
82
 
        GObject parent_instance;
83
 
} BraseroMedium;
84
 
</programlisting>
85
 
<para>
86
 
</para></refsect2>
87
 
<refsect2 id="brasero-medium-get-status" role="function">
88
 
<title>brasero_medium_get_status ()</title>
89
 
<indexterm zone="brasero-medium-get-status"><primary sortas="brasero_medium_get_status">brasero_medium_get_status</primary></indexterm><programlisting><link linkend="BraseroMedia">BraseroMedia</link>        brasero_medium_get_status           (<link linkend="BraseroMedium">BraseroMedium</link> *medium);</programlisting>
90
 
<para>
91
 
Gets the medium type and state.</para>
92
 
<para>
93
 
</para><variablelist role="params">
94
 
<varlistentry><term><parameter>medium</parameter>&#160;:</term>
95
 
<listitem><simpara> <link linkend="BraseroMedium"><type>BraseroMedium</type></link>
96
 
</simpara></listitem></varlistentry>
97
 
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="BraseroMedia"><type>BraseroMedia</type></link>.
98
 
 
99
 
</simpara></listitem></varlistentry>
100
 
</variablelist></refsect2>
101
 
<refsect2 id="brasero-medium-get-max-write-speed" role="function">
102
 
<title>brasero_medium_get_max_write_speed ()</title>
103
 
<indexterm zone="brasero-medium-get-max-write-speed"><primary sortas="brasero_medium_get_max_write_speed">brasero_medium_get_max_write_speed</primary></indexterm><programlisting><link linkend="guint64">guint64</link>             brasero_medium_get_max_write_speed  (<link linkend="BraseroMedium">BraseroMedium</link> *medium);</programlisting>
104
 
<para>
105
 
Gets the maximum speed that can be used to write to <parameter>medium</parameter>.
106
 
Note: the speed are in B/sec.</para>
107
 
<para>
108
 
</para><variablelist role="params">
109
 
<varlistentry><term><parameter>medium</parameter>&#160;:</term>
110
 
<listitem><simpara> <link linkend="BraseroMedium"><type>BraseroMedium</type></link>
111
 
</simpara></listitem></varlistentry>
112
 
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="guint64"><type>guint64</type></link>.
113
 
 
114
 
</simpara></listitem></varlistentry>
115
 
</variablelist></refsect2>
116
 
<refsect2 id="brasero-medium-get-write-speeds" role="function">
117
 
<title>brasero_medium_get_write_speeds ()</title>
118
 
<indexterm zone="brasero-medium-get-write-speeds"><primary sortas="brasero_medium_get_write_speeds">brasero_medium_get_write_speeds</primary></indexterm><programlisting><link linkend="guint64">guint64</link> *           brasero_medium_get_write_speeds     (<link linkend="BraseroMedium">BraseroMedium</link> *medium);</programlisting>
119
 
<para>
120
 
Gets an array holding all possible speeds to write to <parameter>medium</parameter>.
121
 
Note: the speed are in B/sec.</para>
122
 
<para>
123
 
</para><variablelist role="params">
124
 
<varlistentry><term><parameter>medium</parameter>&#160;:</term>
125
 
<listitem><simpara> <link linkend="BraseroMedium"><type>BraseroMedium</type></link>
126
 
</simpara></listitem></varlistentry>
127
 
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="guint64"><type>guint64</type></link> *.
128
 
 
129
 
</simpara></listitem></varlistentry>
130
 
</variablelist></refsect2>
131
 
<refsect2 id="brasero-medium-get-free-space" role="function">
132
 
<title>brasero_medium_get_free_space ()</title>
133
 
<indexterm zone="brasero-medium-get-free-space"><primary sortas="brasero_medium_get_free_space">brasero_medium_get_free_space</primary></indexterm><programlisting><link linkend="void">void</link>                brasero_medium_get_free_space       (<link linkend="BraseroMedium">BraseroMedium</link> *medium,
134
 
                                                         <link linkend="goffset">goffset</link> *bytes,
135
 
                                                         <link linkend="goffset">goffset</link> *blocks);</programlisting>
136
 
<para>
137
 
Stores in either <parameter>size</parameter> (in bytes) or <parameter>blocks</parameter> (the number of blocks) the space
138
 
on the disc that can be used for writing.</para>
139
 
<para>
140
 
</para><variablelist role="params">
141
 
<varlistentry><term><parameter>medium</parameter>&#160;:</term>
142
 
<listitem><simpara> <link linkend="BraseroMedium"><type>BraseroMedium</type></link>
143
 
</simpara></listitem></varlistentry>
144
 
<varlistentry><term><parameter>bytes</parameter>&#160;:</term>
145
 
<listitem><simpara> a <link linkend="gint64"><type>gint64</type></link> * or NULL
146
 
</simpara></listitem></varlistentry>
147
 
<varlistentry><term><parameter>blocks</parameter>&#160;:</term>
148
 
<listitem><simpara> a <link linkend="gint64"><type>gint64</type></link> * or NULL
149
 
</simpara></listitem></varlistentry>
150
 
</variablelist></refsect2>
151
 
<refsect2 id="brasero-medium-get-capacity" role="function">
152
 
<title>brasero_medium_get_capacity ()</title>
153
 
<indexterm zone="brasero-medium-get-capacity"><primary sortas="brasero_medium_get_capacity">brasero_medium_get_capacity</primary></indexterm><programlisting><link linkend="void">void</link>                brasero_medium_get_capacity         (<link linkend="BraseroMedium">BraseroMedium</link> *medium,
154
 
                                                         <link linkend="goffset">goffset</link> *bytes,
155
 
                                                         <link linkend="goffset">goffset</link> *blocks);</programlisting>
156
 
<para>
157
 
Stores in either <parameter>size</parameter> (in bytes) or <parameter>blocks</parameter> (the number of blocks) the total
158
 
disc space.
159
 
Note that when the disc is closed this space is the one occupied by data. 
160
 
Otherwise it is the sum of free and used space.</para>
161
 
<para>
162
 
</para><variablelist role="params">
163
 
<varlistentry><term><parameter>medium</parameter>&#160;:</term>
164
 
<listitem><simpara> <link linkend="BraseroMedium"><type>BraseroMedium</type></link>
165
 
</simpara></listitem></varlistentry>
166
 
<varlistentry><term><parameter>bytes</parameter>&#160;:</term>
167
 
<listitem><simpara> a <link linkend="gint64"><type>gint64</type></link> * or NULL
168
 
</simpara></listitem></varlistentry>
169
 
<varlistentry><term><parameter>blocks</parameter>&#160;:</term>
170
 
<listitem><simpara> a <link linkend="gint64"><type>gint64</type></link> * or NULL
171
 
</simpara></listitem></varlistentry>
172
 
</variablelist></refsect2>
173
 
<refsect2 id="brasero-medium-get-data-size" role="function">
174
 
<title>brasero_medium_get_data_size ()</title>
175
 
<indexterm zone="brasero-medium-get-data-size"><primary sortas="brasero_medium_get_data_size">brasero_medium_get_data_size</primary></indexterm><programlisting><link linkend="void">void</link>                brasero_medium_get_data_size        (<link linkend="BraseroMedium">BraseroMedium</link> *medium,
176
 
                                                         <link linkend="goffset">goffset</link> *bytes,
177
 
                                                         <link linkend="goffset">goffset</link> *blocks);</programlisting>
178
 
<para>
179
 
Stores in either <parameter>size</parameter> (in bytes) or <parameter>blocks</parameter> (the number of blocks) the size
180
 
used to store data (including audio on CDs) on the disc.</para>
181
 
<para>
182
 
</para><variablelist role="params">
183
 
<varlistentry><term><parameter>medium</parameter>&#160;:</term>
184
 
<listitem><simpara> <link linkend="BraseroMedium"><type>BraseroMedium</type></link>
185
 
</simpara></listitem></varlistentry>
186
 
<varlistentry><term><parameter>bytes</parameter>&#160;:</term>
187
 
<listitem><simpara> a <link linkend="gint64"><type>gint64</type></link> * or NULL
188
 
</simpara></listitem></varlistentry>
189
 
<varlistentry><term><parameter>blocks</parameter>&#160;:</term>
190
 
<listitem><simpara> a <link linkend="gint64"><type>gint64</type></link> * or NULL
191
 
</simpara></listitem></varlistentry>
192
 
</variablelist></refsect2>
193
 
<refsect2 id="brasero-medium-get-next-writable-address" role="function">
194
 
<title>brasero_medium_get_next_writable_address ()</title>
195
 
<indexterm zone="brasero-medium-get-next-writable-address"><primary sortas="brasero_medium_get_next_writable_address">brasero_medium_get_next_writable_address</primary></indexterm><programlisting><link linkend="gint64">gint64</link>              brasero_medium_get_next_writable_address
196
 
                                                        (<link linkend="BraseroMedium">BraseroMedium</link> *medium);</programlisting>
197
 
<para>
198
 
Gets the address (block number) that can be used to write a new session on <parameter>medium</parameter></para>
199
 
<para>
200
 
</para><variablelist role="params">
201
 
<varlistentry><term><parameter>medium</parameter>&#160;:</term>
202
 
<listitem><simpara> <link linkend="BraseroMedium"><type>BraseroMedium</type></link>
203
 
</simpara></listitem></varlistentry>
204
 
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="gint64"><type>gint64</type></link>.
205
 
 
206
 
</simpara></listitem></varlistentry>
207
 
</variablelist></refsect2>
208
 
<refsect2 id="brasero-medium-can-be-rewritten" role="function">
209
 
<title>brasero_medium_can_be_rewritten ()</title>
210
 
<indexterm zone="brasero-medium-can-be-rewritten"><primary sortas="brasero_medium_can_be_rewritten">brasero_medium_can_be_rewritten</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            brasero_medium_can_be_rewritten     (<link linkend="BraseroMedium">BraseroMedium</link> *medium);</programlisting>
211
 
<para>
212
 
Gets whether the medium can be rewritten. Note: it also checks that the drive
213
 
can rewrite the medium type.</para>
214
 
<para>
215
 
</para><variablelist role="params">
216
 
<varlistentry><term><parameter>medium</parameter>&#160;:</term>
217
 
<listitem><simpara> <link linkend="BraseroMedium"><type>BraseroMedium</type></link>
218
 
</simpara></listitem></varlistentry>
219
 
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="gboolean"><type>gboolean</type></link>. TRUE if the medium can be rewritten, FALSE otherwise.
220
 
 
221
 
</simpara></listitem></varlistentry>
222
 
</variablelist></refsect2>
223
 
<refsect2 id="brasero-medium-can-be-written" role="function">
224
 
<title>brasero_medium_can_be_written ()</title>
225
 
<indexterm zone="brasero-medium-can-be-written"><primary sortas="brasero_medium_can_be_written">brasero_medium_can_be_written</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            brasero_medium_can_be_written       (<link linkend="BraseroMedium">BraseroMedium</link> *medium);</programlisting>
226
 
<para>
227
 
Gets whether the medium can be written. It also checks that the medium can
228
 
write the medium.</para>
229
 
<para>
230
 
</para><variablelist role="params">
231
 
<varlistentry><term><parameter>medium</parameter>&#160;:</term>
232
 
<listitem><simpara> <link linkend="BraseroMedium"><type>BraseroMedium</type></link>
233
 
</simpara></listitem></varlistentry>
234
 
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="gboolean"><type>gboolean</type></link>. TRUE if the medium can be rewritten, FALSE otherwise.
235
 
 
236
 
</simpara></listitem></varlistentry>
237
 
</variablelist></refsect2>
238
 
<refsect2 id="brasero-medium-get-CD-TEXT-title" role="function">
239
 
<title>brasero_medium_get_CD_TEXT_title ()</title>
240
 
<indexterm zone="brasero-medium-get-CD-TEXT-title"><primary sortas="brasero_medium_get_CD_TEXT_title">brasero_medium_get_CD_TEXT_title</primary></indexterm><programlisting>const <link linkend="gchar">gchar</link> *       brasero_medium_get_CD_TEXT_title    (<link linkend="BraseroMedium">BraseroMedium</link> *medium);</programlisting>
241
 
<para>
242
 
Gets the CD-TEXT title for <parameter>Medium</parameter>.</para>
243
 
<para>
244
 
</para><variablelist role="params">
245
 
<varlistentry><term><parameter>medium</parameter>&#160;:</term>
246
 
<listitem><simpara> <link linkend="BraseroMedium"><type>BraseroMedium</type></link>
247
 
</simpara></listitem></varlistentry>
248
 
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="gchar"><type>gchar</type></link> *.
249
 
 
250
 
</simpara></listitem></varlistentry>
251
 
</variablelist></refsect2>
252
 
<refsect2 id="brasero-medium-get-type-string" role="function">
253
 
<title>brasero_medium_get_type_string ()</title>
254
 
<indexterm zone="brasero-medium-get-type-string"><primary sortas="brasero_medium_get_type_string">brasero_medium_get_type_string</primary></indexterm><programlisting>const <link linkend="gchar">gchar</link> *       brasero_medium_get_type_string      (<link linkend="BraseroMedium">BraseroMedium</link> *medium);</programlisting>
255
 
<para>
256
 
Returns the medium type as a string to be displayed in a UI.</para>
257
 
<para>
258
 
</para><variablelist role="params">
259
 
<varlistentry><term><parameter>medium</parameter>&#160;:</term>
260
 
<listitem><simpara> <link linkend="BraseroMedium"><type>BraseroMedium</type></link>
261
 
</simpara></listitem></varlistentry>
262
 
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="gchar"><type>gchar</type></link> *.
263
 
 
264
 
</simpara></listitem></varlistentry>
265
 
</variablelist></refsect2>
266
 
<refsect2 id="brasero-medium-get-tooltip" role="function">
267
 
<title>brasero_medium_get_tooltip ()</title>
268
 
<indexterm zone="brasero-medium-get-tooltip"><primary sortas="brasero_medium_get_tooltip">brasero_medium_get_tooltip</primary></indexterm><programlisting><link linkend="gchar">gchar</link> *             brasero_medium_get_tooltip          (<link linkend="BraseroMedium">BraseroMedium</link> *medium);</programlisting>
269
 
<para>
270
 
Returns a tooltip to be displayed in the UI.
271
 
It is of the form {content type} {disc type} in {drive name}.</para>
272
 
<para>
273
 
</para><variablelist role="params">
274
 
<varlistentry><term><parameter>medium</parameter>&#160;:</term>
275
 
<listitem><simpara> <link linkend="BraseroMedium"><type>BraseroMedium</type></link>
276
 
</simpara></listitem></varlistentry>
277
 
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="gchar"><type>gchar</type></link> *.
278
 
 
279
 
</simpara></listitem></varlistentry>
280
 
</variablelist></refsect2>
281
 
<refsect2 id="brasero-medium-get-drive" role="function">
282
 
<title>brasero_medium_get_drive ()</title>
283
 
<indexterm zone="brasero-medium-get-drive"><primary sortas="brasero_medium_get_drive">brasero_medium_get_drive</primary></indexterm><programlisting><link linkend="BraseroDrive">BraseroDrive</link> *      brasero_medium_get_drive            (<link linkend="BraseroMedium">BraseroMedium</link> *medium);</programlisting>
284
 
<para>
285
 
Gets the <link linkend="BraseroDrive"><type>BraseroDrive</type></link> in which the medium is inserted.</para>
286
 
<para>
287
 
</para><variablelist role="params">
288
 
<varlistentry><term><parameter>medium</parameter>&#160;:</term>
289
 
<listitem><simpara> <link linkend="BraseroMedium"><type>BraseroMedium</type></link>
290
 
</simpara></listitem></varlistentry>
291
 
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="BraseroDrive"><type>BraseroDrive</type></link>. No need to unref after use.
292
 
 
293
 
</simpara></listitem></varlistentry>
294
 
</variablelist></refsect2>
295
 
<refsect2 id="brasero-medium-get-track-num" role="function">
296
 
<title>brasero_medium_get_track_num ()</title>
297
 
<indexterm zone="brasero-medium-get-track-num"><primary sortas="brasero_medium_get_track_num">brasero_medium_get_track_num</primary></indexterm><programlisting><link linkend="guint">guint</link>               brasero_medium_get_track_num        (<link linkend="BraseroMedium">BraseroMedium</link> *medium);</programlisting>
298
 
<para>
299
 
Gets the number of tracks on the medium.</para>
300
 
<para>
301
 
</para><variablelist role="params">
302
 
<varlistentry><term><parameter>medium</parameter>&#160;:</term>
303
 
<listitem><simpara> <link linkend="BraseroMedium"><type>BraseroMedium</type></link>
304
 
</simpara></listitem></varlistentry>
305
 
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="guint"><type>guint</type></link>.
306
 
 
307
 
</simpara></listitem></varlistentry>
308
 
</variablelist></refsect2>
309
 
<refsect2 id="brasero-medium-get-last-data-track-space" role="function">
310
 
<title>brasero_medium_get_last_data_track_space ()</title>
311
 
<indexterm zone="brasero-medium-get-last-data-track-space"><primary sortas="brasero_medium_get_last_data_track_space">brasero_medium_get_last_data_track_space</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            brasero_medium_get_last_data_track_space
312
 
                                                        (<link linkend="BraseroMedium">BraseroMedium</link> *medium,
313
 
                                                         <link linkend="goffset">goffset</link> *bytes,
314
 
                                                         <link linkend="goffset">goffset</link> *sectors);</programlisting>
315
 
<para>
316
 
Stores in either <parameter>bytes</parameter> (in bytes) or in <parameter>sectors</parameter> (in blocks) the space used by
317
 
the last track on the medium.</para>
318
 
<para>
319
 
</para><variablelist role="params">
320
 
<varlistentry><term><parameter>medium</parameter>&#160;:</term>
321
 
<listitem><simpara> <link linkend="BraseroMedium"><type>BraseroMedium</type></link>
322
 
</simpara></listitem></varlistentry>
323
 
<varlistentry><term><parameter>bytes</parameter>&#160;:</term>
324
 
<listitem><simpara> a <link linkend="goffset"><type>goffset</type></link> * or NULL
325
 
</simpara></listitem></varlistentry>
326
 
<varlistentry><term><parameter>sectors</parameter>&#160;:</term>
327
 
<listitem><simpara> a <link linkend="goffset"><type>goffset</type></link> * or NULL
328
 
</simpara></listitem></varlistentry>
329
 
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="gboolean"><type>gboolean</type></link>. Returns TRUE if information could be retrieved.
330
 
 
331
 
</simpara></listitem></varlistentry>
332
 
</variablelist></refsect2>
333
 
<refsect2 id="brasero-medium-get-last-data-track-address" role="function">
334
 
<title>brasero_medium_get_last_data_track_address ()</title>
335
 
<indexterm zone="brasero-medium-get-last-data-track-address"><primary sortas="brasero_medium_get_last_data_track_address">brasero_medium_get_last_data_track_address</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            brasero_medium_get_last_data_track_address
336
 
                                                        (<link linkend="BraseroMedium">BraseroMedium</link> *medium,
337
 
                                                         <link linkend="goffset">goffset</link> *bytes,
338
 
                                                         <link linkend="goffset">goffset</link> *sectors);</programlisting>
339
 
<para>
340
 
Stores in either <parameter>bytes</parameter> (in bytes) or in <parameter>sectors</parameter> (in blocks) the address where
341
 
the last session starts. This is useful when creating a multisession image or
342
 
when reading the contents of this last track.</para>
343
 
<para>
344
 
</para><variablelist role="params">
345
 
<varlistentry><term><parameter>medium</parameter>&#160;:</term>
346
 
<listitem><simpara> <link linkend="BraseroMedium"><type>BraseroMedium</type></link>
347
 
</simpara></listitem></varlistentry>
348
 
<varlistentry><term><parameter>bytes</parameter>&#160;:</term>
349
 
<listitem><simpara> a <link linkend="goffset"><type>goffset</type></link> * or NULL
350
 
</simpara></listitem></varlistentry>
351
 
<varlistentry><term><parameter>sectors</parameter>&#160;:</term>
352
 
<listitem><simpara> a <link linkend="goffset"><type>goffset</type></link> * or NULL
353
 
</simpara></listitem></varlistentry>
354
 
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="gboolean"><type>gboolean</type></link>. Returns TRUE if information could be retrieved.
355
 
 
356
 
</simpara></listitem></varlistentry>
357
 
</variablelist></refsect2>
358
 
<refsect2 id="brasero-medium-get-track-space" role="function">
359
 
<title>brasero_medium_get_track_space ()</title>
360
 
<indexterm zone="brasero-medium-get-track-space"><primary sortas="brasero_medium_get_track_space">brasero_medium_get_track_space</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            brasero_medium_get_track_space      (<link linkend="BraseroMedium">BraseroMedium</link> *medium,
361
 
                                                         <link linkend="guint">guint</link> num,
362
 
                                                         <link linkend="goffset">goffset</link> *bytes,
363
 
                                                         <link linkend="goffset">goffset</link> *sectors);</programlisting>
364
 
<para>
365
 
Stores in either <parameter>bytes</parameter> (in bytes) or in <parameter>sectors</parameter> (in blocks) the space used
366
 
by session <parameter>num</parameter> on the disc.</para>
367
 
<para>
368
 
</para><variablelist role="params">
369
 
<varlistentry><term><parameter>medium</parameter>&#160;:</term>
370
 
<listitem><simpara> a <link linkend="BraseroMedium"><type>BraseroMedium</type></link>
371
 
</simpara></listitem></varlistentry>
372
 
<varlistentry><term><parameter>num</parameter>&#160;:</term>
373
 
<listitem><simpara> a <link linkend="guint"><type>guint</type></link>
374
 
</simpara></listitem></varlistentry>
375
 
<varlistentry><term><parameter>bytes</parameter>&#160;:</term>
376
 
<listitem><simpara> a <link linkend="goffset"><type>goffset</type></link> * or NULL
377
 
</simpara></listitem></varlistentry>
378
 
<varlistentry><term><parameter>sectors</parameter>&#160;:</term>
379
 
<listitem><simpara> a <link linkend="goffset"><type>goffset</type></link> * or NULL
380
 
</simpara></listitem></varlistentry>
381
 
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="gboolean"><type>gboolean</type></link>. Returns TRUE if information could be retrieved;
382
 
FALSE otherwise (usually when track <parameter>num</parameter> doesn't exist).
383
 
 
384
 
</simpara></listitem></varlistentry>
385
 
</variablelist></refsect2>
386
 
<refsect2 id="brasero-medium-get-track-address" role="function">
387
 
<title>brasero_medium_get_track_address ()</title>
388
 
<indexterm zone="brasero-medium-get-track-address"><primary sortas="brasero_medium_get_track_address">brasero_medium_get_track_address</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            brasero_medium_get_track_address    (<link linkend="BraseroMedium">BraseroMedium</link> *medium,
389
 
                                                         <link linkend="guint">guint</link> num,
390
 
                                                         <link linkend="goffset">goffset</link> *bytes,
391
 
                                                         <link linkend="goffset">goffset</link> *sectors);</programlisting>
392
 
<para>
393
 
Stores in either <parameter>bytes</parameter> (in bytes) or in <parameter>sectors</parameter> (in blocks) the address at
394
 
which the session identified by <parameter>num</parameter> starts.</para>
395
 
<para>
396
 
</para><variablelist role="params">
397
 
<varlistentry><term><parameter>medium</parameter>&#160;:</term>
398
 
<listitem><simpara> a <link linkend="BraseroMedium"><type>BraseroMedium</type></link>
399
 
</simpara></listitem></varlistentry>
400
 
<varlistentry><term><parameter>num</parameter>&#160;:</term>
401
 
<listitem><simpara> a <link linkend="guint"><type>guint</type></link>
402
 
</simpara></listitem></varlistentry>
403
 
<varlistentry><term><parameter>bytes</parameter>&#160;:</term>
404
 
<listitem><simpara> a <link linkend="goffset"><type>goffset</type></link> * or NULL
405
 
</simpara></listitem></varlistentry>
406
 
<varlistentry><term><parameter>sectors</parameter>&#160;:</term>
407
 
<listitem><simpara> a <link linkend="goffset"><type>goffset</type></link> * or NULL
408
 
</simpara></listitem></varlistentry>
409
 
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="gboolean"><type>gboolean</type></link>. Returns TRUE if information could be retrieved;
410
 
FALSE otherwise (usually when track <parameter>num</parameter> doesn't exist).
411
 
 
412
 
</simpara></listitem></varlistentry>
413
 
</variablelist></refsect2>
414
 
<refsect2 id="brasero-medium-can-use-dummy-for-sao" role="function">
415
 
<title>brasero_medium_can_use_dummy_for_sao ()</title>
416
 
<indexterm zone="brasero-medium-can-use-dummy-for-sao"><primary sortas="brasero_medium_can_use_dummy_for_sao">brasero_medium_can_use_dummy_for_sao</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            brasero_medium_can_use_dummy_for_sao
417
 
                                                        (<link linkend="BraseroMedium">BraseroMedium</link> *medium);</programlisting>
418
 
<para>
419
 
Gets whether the medium supports doing a test write with SAO on.</para>
420
 
<para>
421
 
</para><variablelist role="params">
422
 
<varlistentry><term><parameter>medium</parameter>&#160;:</term>
423
 
<listitem><simpara> <link linkend="BraseroMedium"><type>BraseroMedium</type></link>
424
 
</simpara></listitem></varlistentry>
425
 
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="gboolean"><type>gboolean</type></link>. TRUE if the medium can use SAO write mode during a test write, FALSE otherwise.
426
 
 
427
 
</simpara></listitem></varlistentry>
428
 
</variablelist></refsect2>
429
 
<refsect2 id="brasero-medium-can-use-dummy-for-tao" role="function">
430
 
<title>brasero_medium_can_use_dummy_for_tao ()</title>
431
 
<indexterm zone="brasero-medium-can-use-dummy-for-tao"><primary sortas="brasero_medium_can_use_dummy_for_tao">brasero_medium_can_use_dummy_for_tao</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            brasero_medium_can_use_dummy_for_tao
432
 
                                                        (<link linkend="BraseroMedium">BraseroMedium</link> *medium);</programlisting>
433
 
<para>
434
 
Gets whether the medium supports doing a test write with TAO on.</para>
435
 
<para>
436
 
</para><variablelist role="params">
437
 
<varlistentry><term><parameter>medium</parameter>&#160;:</term>
438
 
<listitem><simpara> <link linkend="BraseroMedium"><type>BraseroMedium</type></link>
439
 
</simpara></listitem></varlistentry>
440
 
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="gboolean"><type>gboolean</type></link>. TRUE if the medium can use TAO write mode during a test write, FALSE otherwise.
441
 
 
442
 
</simpara></listitem></varlistentry>
443
 
</variablelist></refsect2>
444
 
<refsect2 id="brasero-medium-can-use-burnfree" role="function">
445
 
<title>brasero_medium_can_use_burnfree ()</title>
446
 
<indexterm zone="brasero-medium-can-use-burnfree"><primary sortas="brasero_medium_can_use_burnfree">brasero_medium_can_use_burnfree</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            brasero_medium_can_use_burnfree     (<link linkend="BraseroMedium">BraseroMedium</link> *medium);</programlisting>
447
 
<para>
448
 
Gets whether the medium supports any burnfree technology.</para>
449
 
<para>
450
 
</para><variablelist role="params">
451
 
<varlistentry><term><parameter>medium</parameter>&#160;:</term>
452
 
<listitem><simpara> <link linkend="BraseroMedium"><type>BraseroMedium</type></link>
453
 
</simpara></listitem></varlistentry>
454
 
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="gboolean"><type>gboolean</type></link>. TRUE if the medium can use any burnfree technology, FALSE otherwise.
455
 
 
456
 
</simpara></listitem></varlistentry>
457
 
</variablelist></refsect2>
458
 
 
459
 
</refsect1>
460
 
 
461
 
 
462
 
 
463
 
 
464
 
</refentry>