CoCalc -- audio.xml

GitHub Repository: awilliam/linux-vfio
Path: blob/master/Documentation/DocBook/dvb/audio.xml
¹⁰⁸²³ views
1
<title>DVB Audio Device</title>
2
<para>The DVB audio device controls the MPEG2 audio decoder of the DVB hardware. It
3
can be accessed through <emphasis role="tt">/dev/dvb/adapter0/audio0</emphasis>. Data types and and
4
ioctl definitions can be accessed by including <emphasis role="tt">linux/dvb/video.h</emphasis> in your
5
application.
6
</para>
7
<para>Please note that some DVB cards don&#8217;t have their own MPEG decoder, which results in
8
the omission of the audio and video device.
9
</para>
10

11
<section id="audio_data_types">
12
<title>Audio Data Types</title>
13
<para>This section describes the structures, data types and defines used when talking to the
14
audio device.
15
</para>
16

17
<section id="audio_stream_source_t">
18
<title>audio_stream_source_t</title>
19
<para>The audio stream source is set through the AUDIO_SELECT_SOURCE call and can take
20
the following values, depending on whether we are replaying from an internal (demux) or
21
external (user write) source.
22
</para>
23
<programlisting>
24
 typedef enum {
25
	 AUDIO_SOURCE_DEMUX,
26
	 AUDIO_SOURCE_MEMORY
27
 } audio_stream_source_t;
28
</programlisting>
29
<para>AUDIO_SOURCE_DEMUX selects the demultiplexer (fed either by the frontend or the
30
DVR device) as the source of the video stream. If AUDIO_SOURCE_MEMORY
31
is selected the stream comes from the application through the <emphasis role="tt">write()</emphasis> system
32
call.
33
</para>
34

35
</section>
36
<section id="audio_play_state_t">
37
<title>audio_play_state_t</title>
38
<para>The following values can be returned by the AUDIO_GET_STATUS call representing the
39
state of audio playback.
40
</para>
41
<programlisting>
42
 typedef enum {
43
	 AUDIO_STOPPED,
44
	 AUDIO_PLAYING,
45
	 AUDIO_PAUSED
46
 } audio_play_state_t;
47
</programlisting>
48

49
</section>
50
<section id="audio_channel_select_t">
51
<title>audio_channel_select_t</title>
52
<para>The audio channel selected via AUDIO_CHANNEL_SELECT is determined by the
53
following values.
54
</para>
55
<programlisting>
56
 typedef enum {
57
	 AUDIO_STEREO,
58
	 AUDIO_MONO_LEFT,
59
	 AUDIO_MONO_RIGHT,
60
 } audio_channel_select_t;
61
</programlisting>
62

63
</section>
64
<section id="struct_audio_status">
65
<title>struct audio_status</title>
66
<para>The AUDIO_GET_STATUS call returns the following structure informing about various
67
states of the playback operation.
68
</para>
69
<programlisting>
70
 typedef struct audio_status {
71
	 boolean AV_sync_state;
72
	 boolean mute_state;
73
	 audio_play_state_t play_state;
74
	 audio_stream_source_t stream_source;
75
	 audio_channel_select_t channel_select;
76
	 boolean bypass_mode;
77
 } audio_status_t;
78
</programlisting>
79

80
</section>
81
<section id="struct_audio_mixer">
82
<title>struct audio_mixer</title>
83
<para>The following structure is used by the AUDIO_SET_MIXER call to set the audio
84
volume.
85
</para>
86
<programlisting>
87
 typedef struct audio_mixer {
88
	 unsigned int volume_left;
89
	 unsigned int volume_right;
90
 } audio_mixer_t;
91
</programlisting>
92

93
</section>
94
<section id="audio_encodings">
95
<title>audio encodings</title>
96
<para>A call to AUDIO_GET_CAPABILITIES returns an unsigned integer with the following
97
bits set according to the hardwares capabilities.
98
</para>
99
<programlisting>
100
 #define AUDIO_CAP_DTS    1
101
 #define AUDIO_CAP_LPCM   2
102
 #define AUDIO_CAP_MP1    4
103
 #define AUDIO_CAP_MP2    8
104
 #define AUDIO_CAP_MP3   16
105
 #define AUDIO_CAP_AAC   32
106
 #define AUDIO_CAP_OGG   64
107
 #define AUDIO_CAP_SDDS 128
108
 #define AUDIO_CAP_AC3  256
109
</programlisting>
110

111
</section>
112
<section id="struct_audio_karaoke">
113
<title>struct audio_karaoke</title>
114
<para>The ioctl AUDIO_SET_KARAOKE uses the following format:
115
</para>
116
<programlisting>
117
 typedef
118
 struct audio_karaoke{
119
	 int vocal1;
120
	 int vocal2;
121
	 int melody;
122
 } audio_karaoke_t;
123
</programlisting>
124
<para>If Vocal1 or Vocal2 are non-zero, they get mixed into left and right t at 70% each. If both,
125
Vocal1 and Vocal2 are non-zero, Vocal1 gets mixed into the left channel and Vocal2 into the
126
right channel at 100% each. Ff Melody is non-zero, the melody channel gets mixed into left
127
and right.
128
</para>
129

130
</section>
131
<section id="audio_attributes">
132
<title>audio attributes</title>
133
<para>The following attributes can be set by a call to AUDIO_SET_ATTRIBUTES:
134
</para>
135
<programlisting>
136
 typedef uint16_t audio_attributes_t;
137
 /&#x22C6;   bits: descr. &#x22C6;/
138
 /&#x22C6;   15-13 audio coding mode (0=ac3, 2=mpeg1, 3=mpeg2ext, 4=LPCM, 6=DTS, &#x22C6;/
139
 /&#x22C6;   12    multichannel extension &#x22C6;/
140
 /&#x22C6;   11-10 audio type (0=not spec, 1=language included) &#x22C6;/
141
 /&#x22C6;    9- 8 audio application mode (0=not spec, 1=karaoke, 2=surround) &#x22C6;/
142
 /&#x22C6;    7- 6 Quantization / DRC (mpeg audio: 1=DRC exists)(lpcm: 0=16bit,  &#x22C6;/
143
 /&#x22C6;    5- 4 Sample frequency fs (0=48kHz, 1=96kHz) &#x22C6;/
144
 /&#x22C6;    2- 0 number of audio channels (n+1 channels) &#x22C6;/
145
</programlisting>
146
 </section></section>
147
<section id="audio_function_calls">
148
<title>Audio Function Calls</title>
149

150

151
<section id="audio_fopen">
152
<title>open()</title>
153
<para>DESCRIPTION
154
</para>
155
<informaltable><tgroup cols="1"><tbody><row><entry
156
 align="char">
157
<para>This system call opens a named audio device (e.g. /dev/dvb/adapter0/audio0)
158
 for subsequent use. When an open() call has succeeded, the device will be ready
159
 for use. The significance of blocking or non-blocking mode is described in the
160
 documentation for functions where there is a difference. It does not affect the
161
 semantics of the open() call itself. A device opened in blocking mode can later
162
 be put into non-blocking mode (and vice versa) using the F_SETFL command
163
 of the fcntl system call. This is a standard system call, documented in the Linux
164
 manual page for fcntl. Only one user can open the Audio Device in O_RDWR
165
 mode. All other attempts to open the device in this mode will fail, and an error
166
 code will be returned. If the Audio Device is opened in O_RDONLY mode, the
167
 only ioctl call that can be used is AUDIO_GET_STATUS. All other call will
168
 return with an error code.</para>
169
</entry>
170
 </row></tbody></tgroup></informaltable>
171
<para>SYNOPSIS
172
</para>
173
<informaltable><tgroup cols="1"><tbody><row><entry
174
 align="char">
175
<para>int open(const char &#x22C6;deviceName, int flags);</para>
176
</entry>
177
 </row></tbody></tgroup></informaltable>
178
<para>PARAMETERS
179
</para>
180
<informaltable><tgroup cols="2"><tbody><row><entry
181
 align="char">
182
<para>const char
183
 *deviceName</para>
184
</entry><entry
185
 align="char">
186
<para>Name of specific audio device.</para>
187
</entry>
188
 </row><row><entry
189
 align="char">
190
<para>int flags</para>
191
</entry><entry
192
 align="char">
193
<para>A bit-wise OR of the following flags:</para>
194
</entry>
195
 </row><row><entry
196
 align="char">
197
</entry><entry
198
 align="char">
199
<para>O_RDONLY read-only access</para>
200
</entry>
201
 </row><row><entry
202
 align="char">
203
</entry><entry
204
 align="char">
205
<para>O_RDWR read/write access</para>
206
</entry>
207
 </row><row><entry
208
 align="char">
209
</entry><entry
210
 align="char">
211
<para>O_NONBLOCK open in non-blocking mode</para>
212
</entry>
213
 </row><row><entry
214
 align="char">
215
</entry><entry
216
 align="char">
217
<para>(blocking mode is the default)</para>
218
</entry>
219
 </row></tbody></tgroup></informaltable>
220
<para>ERRORS
221
</para>
222
<informaltable><tgroup cols="2"><tbody><row><entry
223
 align="char">
224
<para>ENODEV</para>
225
</entry><entry
226
 align="char">
227
<para>Device driver not loaded/available.</para>
228
</entry>
229
 </row><row><entry
230
 align="char">
231
<para>EINTERNAL</para>
232
</entry><entry
233
 align="char">
234
<para>Internal error.</para>
235
</entry>
236
 </row><row><entry
237
 align="char">
238
<para>EBUSY</para>
239
</entry><entry
240
 align="char">
241
<para>Device or resource busy.</para>
242
</entry>
243
 </row><row><entry
244
 align="char">
245
<para>EINVAL</para>
246
</entry><entry
247
 align="char">
248
<para>Invalid argument.</para>
249
</entry>
250
 </row></tbody></tgroup></informaltable>
251

252
</section>
253
<section id="audio_fclose">
254
<title>close()</title>
255
<para>DESCRIPTION
256
</para>
257
<informaltable><tgroup cols="1"><tbody><row><entry
258
 align="char">
259
<para>This system call closes a previously opened audio device.</para>
260
</entry>
261
 </row></tbody></tgroup></informaltable>
262
<para>SYNOPSIS
263
</para>
264
<informaltable><tgroup cols="1"><tbody><row><entry
265
 align="char">
266
<para>int close(int fd);</para>
267
</entry>
268
 </row></tbody></tgroup></informaltable>
269
<para>PARAMETERS
270
</para>
271
<informaltable><tgroup cols="2"><tbody><row><entry
272
 align="char">
273
<para>int fd</para>
274
</entry><entry
275
 align="char">
276
<para>File descriptor returned by a previous call to open().</para>
277
</entry>
278
 </row></tbody></tgroup></informaltable>
279
<para>ERRORS
280
</para>
281
<informaltable><tgroup cols="2"><tbody><row><entry
282
 align="char">
283
<para>EBADF</para>
284
</entry><entry
285
 align="char">
286
<para>fd is not a valid open file descriptor.</para>
287
</entry>
288
 </row></tbody></tgroup></informaltable>
289

290
</section>
291
<section id="audio_fwrite">
292
<title>write()</title>
293
<para>DESCRIPTION
294
</para>
295
<informaltable><tgroup cols="1"><tbody><row><entry
296
 align="char">
297
<para>This system call can only be used if AUDIO_SOURCE_MEMORY is selected
298
 in the ioctl call AUDIO_SELECT_SOURCE. The data provided shall be in
299
 PES format. If O_NONBLOCK is not specified the function will block until
300
 buffer space is available. The amount of data to be transferred is implied by
301
 count.</para>
302
</entry>
303
 </row></tbody></tgroup></informaltable>
304
<para>SYNOPSIS
305
</para>
306
<informaltable><tgroup cols="1"><tbody><row><entry
307
 align="char">
308
<para>size_t write(int fd, const void &#x22C6;buf, size_t count);</para>
309
</entry>
310
 </row></tbody></tgroup></informaltable>
311
<para>PARAMETERS
312
</para>
313
<informaltable><tgroup cols="2"><tbody><row><entry
314
 align="char">
315
<para>int fd</para>
316
</entry><entry
317
 align="char">
318
<para>File descriptor returned by a previous call to open().</para>
319
</entry>
320
 </row><row><entry
321
 align="char">
322
<para>void *buf</para>
323
</entry><entry
324
 align="char">
325
<para>Pointer to the buffer containing the PES data.</para>
326
</entry>
327
 </row><row><entry
328
 align="char">
329
<para>size_t count</para>
330
</entry><entry
331
 align="char">
332
<para>Size of buf.</para>
333
</entry>
334
 </row></tbody></tgroup></informaltable>
335
<para>ERRORS
336
</para>
337
<informaltable><tgroup cols="2"><tbody><row><entry
338
 align="char">
339
<para>EPERM</para>
340
</entry><entry
341
 align="char">
342
<para>Mode AUDIO_SOURCE_MEMORY not selected.</para>
343
</entry>
344
 </row><row><entry
345
 align="char">
346
<para>ENOMEM</para>
347
</entry><entry
348
 align="char">
349
<para>Attempted to write more data than the internal buffer can
350
 hold.</para>
351
</entry>
352
 </row><row><entry
353
 align="char">
354
<para>EBADF</para>
355
</entry><entry
356
 align="char">
357
<para>fd is not a valid open file descriptor.</para>
358
</entry>
359
 </row></tbody></tgroup></informaltable>
360

361
</section><section
362
role="subsection"><title>AUDIO_STOP</title>
363
<para>DESCRIPTION
364
</para>
365
<informaltable><tgroup cols="1"><tbody><row><entry
366
 align="char">
367
<para>This ioctl call asks the Audio Device to stop playing the current stream.</para>
368
</entry>
369
 </row></tbody></tgroup></informaltable>
370
<para>SYNOPSIS
371
</para>
372
<informaltable><tgroup cols="1"><tbody><row><entry
373
 align="char">
374
<para>int ioctl(int fd, int request = AUDIO_STOP);</para>
375
</entry>
376
 </row></tbody></tgroup></informaltable>
377
<para>PARAMETERS
378
</para>
379
<informaltable><tgroup cols="2"><tbody><row><entry
380
 align="char">
381
<para>int fd</para>
382
</entry><entry
383
 align="char">
384
<para>File descriptor returned by a previous call to open().</para>
385
</entry>
386
 </row><row><entry
387
 align="char">
388
<para>int request</para>
389
</entry><entry
390
 align="char">
391
<para>Equals AUDIO_STOP for this command.</para>
392
</entry>
393
 </row></tbody></tgroup></informaltable>
394
<para>ERRORS
395
</para>
396
<informaltable><tgroup cols="2"><tbody><row><entry
397
 align="char">
398
<para>EBADF</para>
399
</entry><entry
400
 align="char">
401
<para>fd is not a valid open file descriptor</para>
402
</entry>
403
 </row><row><entry
404
 align="char">
405
<para>EINTERNAL</para>
406
</entry><entry
407
 align="char">
408
<para>Internal error.</para>
409
</entry>
410
 </row></tbody></tgroup></informaltable>
411

412
</section><section
413
role="subsection"><title>AUDIO_PLAY</title>
414
<para>DESCRIPTION
415
</para>
416
<informaltable><tgroup cols="1"><tbody><row><entry
417
 align="char">
418
<para>This ioctl call asks the Audio Device to start playing an audio stream from the
419
 selected source.</para>
420
</entry>
421
 </row></tbody></tgroup></informaltable>
422
<para>SYNOPSIS
423
</para>
424
<informaltable><tgroup cols="1"><tbody><row><entry
425
 align="char">
426
<para>int ioctl(int fd, int request = AUDIO_PLAY);</para>
427
</entry>
428
 </row></tbody></tgroup></informaltable>
429
<para>PARAMETERS
430
</para>
431
<informaltable><tgroup cols="2"><tbody><row><entry
432
 align="char">
433
<para>int fd</para>
434
</entry><entry
435
 align="char">
436
<para>File descriptor returned by a previous call to open().</para>
437
</entry>
438
 </row><row><entry
439
 align="char">
440
<para>int request</para>
441
</entry><entry
442
 align="char">
443
<para>Equals AUDIO_PLAY for this command.</para>
444
</entry>
445
 </row></tbody></tgroup></informaltable>
446
<para>ERRORS
447
</para>
448
<informaltable><tgroup cols="2"><tbody><row><entry
449
 align="char">
450
<para>EBADF</para>
451
</entry><entry
452
 align="char">
453
<para>fd is not a valid open file descriptor</para>
454
</entry>
455
 </row><row><entry
456
 align="char">
457
<para>EINTERNAL</para>
458
</entry><entry
459
 align="char">
460
<para>Internal error.</para>
461
</entry>
462
 </row></tbody></tgroup></informaltable>
463

464
</section><section
465
role="subsection"><title>AUDIO_PAUSE</title>
466
<para>DESCRIPTION
467
</para>
468
<informaltable><tgroup cols="1"><tbody><row><entry
469
 align="char">
470
<para>This ioctl call suspends the audio stream being played. Decoding and playing
471
 are paused. It is then possible to restart again decoding and playing process of
472
 the audio stream using AUDIO_CONTINUE command.</para>
473
</entry>
474
 </row><row><entry
475
 align="char">
476
<para>If AUDIO_SOURCE_MEMORY is selected in the ioctl call
477
 AUDIO_SELECT_SOURCE, the DVB-subsystem will not decode (consume)
478
 any more data until the ioctl call AUDIO_CONTINUE or AUDIO_PLAY is
479
 performed.</para>
480
</entry>
481
 </row></tbody></tgroup></informaltable>
482
<para>SYNOPSIS
483
</para>
484
<informaltable><tgroup cols="1"><tbody><row><entry
485
 align="char">
486
<para>int ioctl(int fd, int request = AUDIO_PAUSE);</para>
487
</entry>
488
 </row></tbody></tgroup></informaltable>
489
<para>PARAMETERS
490
</para>
491
<informaltable><tgroup cols="2"><tbody><row><entry
492
 align="char">
493
<para>int fd</para>
494
</entry><entry
495
 align="char">
496
<para>File descriptor returned by a previous call to open().</para>
497
</entry>
498
 </row><row><entry
499
 align="char">
500
<para>int request</para>
501
</entry><entry
502
 align="char">
503
<para>Equals AUDIO_PAUSE for this command.</para>
504
</entry>
505
 </row></tbody></tgroup></informaltable>
506
<para>ERRORS
507
</para>
508
<informaltable><tgroup cols="2"><tbody><row><entry
509
 align="char">
510
<para>EBADF</para>
511
</entry><entry
512
 align="char">
513
<para>fd is not a valid open file descriptor.</para>
514
</entry>
515
 </row><row><entry
516
 align="char">
517
<para>EINTERNAL</para>
518
</entry><entry
519
 align="char">
520
<para>Internal error.</para>
521
</entry>
522
 </row></tbody></tgroup></informaltable>
523

524
</section><section
525
role="subsection"><title>AUDIO_SELECT_SOURCE</title>
526
<para>DESCRIPTION
527
</para>
528
<informaltable><tgroup cols="1"><tbody><row><entry
529
 align="char">
530
<para>This ioctl call informs the audio device which source shall be used
531
 for the input data. The possible sources are demux or memory. If
532
 AUDIO_SOURCE_MEMORY is selected, the data is fed to the Audio Device
533
 through the write command.</para>
534
</entry>
535
 </row></tbody></tgroup></informaltable>
536
<para>SYNOPSIS
537
</para>
538
<informaltable><tgroup cols="1"><tbody><row><entry
539
 align="char">
540
<para>int ioctl(int fd, int request = AUDIO_SELECT_SOURCE,
541
 audio_stream_source_t source);</para>
542
</entry>
543
 </row></tbody></tgroup></informaltable>
544
<para>PARAMETERS
545
</para>
546
<informaltable><tgroup cols="2"><tbody><row><entry
547
 align="char">
548
<para>int fd</para>
549
</entry><entry
550
 align="char">
551
<para>File descriptor returned by a previous call to open().</para>
552
</entry>
553
 </row><row><entry
554
 align="char">
555
<para>int request</para>
556
</entry><entry
557
 align="char">
558
<para>Equals AUDIO_SELECT_SOURCE for this command.</para>
559
</entry>
560
 </row><row><entry
561
 align="char">
562
<para>audio_stream_source_t
563
 source</para>
564
</entry><entry
565
 align="char">
566
<para>Indicates the source that shall be used for the Audio
567
 stream.</para>
568
</entry>
569
 </row></tbody></tgroup></informaltable>
570
<para>ERRORS
571
</para>
572
<informaltable><tgroup cols="2"><tbody><row><entry
573
 align="char">
574
<para>EBADF</para>
575
</entry><entry
576
 align="char">
577
<para>fd is not a valid open file descriptor.</para>
578
</entry>
579
 </row><row><entry
580
 align="char">
581
<para>EINTERNAL</para>
582
</entry><entry
583
 align="char">
584
<para>Internal error.</para>
585
</entry>
586
 </row><row><entry
587
 align="char">
588
<para>EINVAL</para>
589
</entry><entry
590
 align="char">
591
<para>Illegal input parameter.</para>
592
</entry>
593
 </row></tbody></tgroup></informaltable>
594

595
</section><section
596
role="subsection"><title>AUDIO_SET_MUTE</title>
597
<para>DESCRIPTION
598
</para>
599
<informaltable><tgroup cols="1"><tbody><row><entry
600
 align="char">
601
<para>This ioctl call asks the audio device to mute the stream that is currently being
602
 played.</para>
603
</entry>
604
 </row></tbody></tgroup></informaltable>
605
<para>SYNOPSIS
606
</para>
607
<informaltable><tgroup cols="1"><tbody><row><entry
608
 align="char">
609
<para>int ioctl(int fd, int request = AUDIO_SET_MUTE,
610
 boolean state);</para>
611
</entry>
612
 </row></tbody></tgroup></informaltable>
613
<para>PARAMETERS
614
</para>
615
<informaltable><tgroup cols="2"><tbody><row><entry
616
 align="char">
617
<para>int fd</para>
618
</entry><entry
619
 align="char">
620
<para>File descriptor returned by a previous call to open().</para>
621
</entry>
622
 </row><row><entry
623
 align="char">
624
<para>int request</para>
625
</entry><entry
626
 align="char">
627
<para>Equals AUDIO_SET_MUTE for this command.</para>
628
</entry>
629
 </row><row><entry
630
 align="char">
631
<para>boolean state</para>
632
</entry><entry
633
 align="char">
634
<para>Indicates if audio device shall mute or not.</para>
635
</entry>
636
 </row><row><entry
637
 align="char">
638
</entry><entry
639
 align="char">
640
<para>TRUE Audio Mute</para>
641
</entry>
642
 </row><row><entry
643
 align="char">
644
</entry><entry
645
 align="char">
646
<para>FALSE Audio Un-mute</para>
647
</entry>
648
 </row></tbody></tgroup></informaltable>
649
<para>ERRORS
650
</para>
651
<informaltable><tgroup cols="2"><tbody><row><entry
652
 align="char">
653
<para>EBADF</para>
654
</entry><entry
655
 align="char">
656
<para>fd is not a valid open file descriptor.</para>
657
</entry>
658
 </row><row><entry
659
 align="char">
660
<para>EINTERNAL</para>
661
</entry><entry
662
 align="char">
663
<para>Internal error.</para>
664
</entry>
665
 </row><row><entry
666
 align="char">
667
<para>EINVAL</para>
668
</entry><entry
669
 align="char">
670
<para>Illegal input parameter.</para>
671
</entry>
672
 </row></tbody></tgroup></informaltable>
673

674
</section><section
675
role="subsection"><title>AUDIO_SET_AV_SYNC</title>
676
<para>DESCRIPTION
677
</para>
678
<informaltable><tgroup cols="1"><tbody><row><entry
679
 align="char">
680
<para>This ioctl call asks the Audio Device to turn ON or OFF A/V synchronization.</para>
681
</entry>
682
 </row></tbody></tgroup></informaltable>
683
<para>SYNOPSIS
684
</para>
685
<informaltable><tgroup cols="1"><tbody><row><entry
686
 align="char">
687
<para>int ioctl(int fd, int request = AUDIO_SET_AV_SYNC,
688
 boolean state);</para>
689
</entry>
690
 </row></tbody></tgroup></informaltable>
691
<para>PARAMETERS
692
</para>
693
<informaltable><tgroup cols="2"><tbody><row><entry
694
 align="char">
695
<para>int fd</para>
696
</entry><entry
697
 align="char">
698
<para>File descriptor returned by a previous call to open().</para>
699
</entry>
700
 </row><row><entry
701
 align="char">
702
<para>int request</para>
703
</entry><entry
704
 align="char">
705
<para>Equals AUDIO_AV_SYNC for this command.</para>
706
</entry>
707
 </row><row><entry
708
 align="char">
709
<para>boolean state</para>
710
</entry><entry
711
 align="char">
712
<para>Tells the DVB subsystem if A/V synchronization shall be
713
 ON or OFF.</para>
714
</entry>
715
 </row><row><entry
716
 align="char">
717
</entry><entry
718
 align="char">
719
<para>TRUE AV-sync ON</para>
720
</entry>
721
 </row><row><entry
722
 align="char">
723
</entry><entry
724
 align="char">
725
<para>FALSE AV-sync OFF</para>
726
</entry>
727
 </row></tbody></tgroup></informaltable>
728
<para>ERRORS
729
</para>
730
<informaltable><tgroup cols="2"><tbody><row><entry
731
 align="char">
732
<para>EBADF</para>
733
</entry><entry
734
 align="char">
735
<para>fd is not a valid open file descriptor.</para>
736
</entry>
737
 </row><row><entry
738
 align="char">
739
<para>EINTERNAL</para>
740
</entry><entry
741
 align="char">
742
<para>Internal error.</para>
743
</entry>
744
 </row><row><entry
745
 align="char">
746
<para>EINVAL</para>
747
</entry><entry
748
 align="char">
749
<para>Illegal input parameter.</para>
750
</entry>
751
 </row></tbody></tgroup></informaltable>
752

753
</section><section
754
role="subsection"><title>AUDIO_SET_BYPASS_MODE</title>
755
<para>DESCRIPTION
756
</para>
757
<informaltable><tgroup cols="1"><tbody><row><entry
758
 align="char">
759
<para>This ioctl call asks the Audio Device to bypass the Audio decoder and forward
760
 the stream without decoding. This mode shall be used if streams that can&#8217;t be
761
 handled by the DVB system shall be decoded. Dolby DigitalTM streams are
762
 automatically forwarded by the DVB subsystem if the hardware can handle it.</para>
763
</entry>
764
 </row></tbody></tgroup></informaltable>
765
<para>SYNOPSIS
766
</para>
767
<informaltable><tgroup cols="1"><tbody><row><entry
768
 align="char">
769
<para>int ioctl(int fd, int request =
770
 AUDIO_SET_BYPASS_MODE, boolean mode);</para>
771
</entry>
772
 </row></tbody></tgroup></informaltable>
773
<para>PARAMETERS
774
</para>
775
<informaltable><tgroup cols="2"><tbody><row><entry
776
 align="char">
777
<para>int fd</para>
778
</entry><entry
779
 align="char">
780
<para>File descriptor returned by a previous call to open().</para>
781
</entry>
782
 </row><row><entry
783
 align="char">
784
<para>int request</para>
785
</entry><entry
786
 align="char">
787
<para>Equals AUDIO_SET_BYPASS_MODE for this
788
 command.</para>
789
</entry>
790
 </row><row><entry
791
 align="char">
792
<para>boolean mode</para>
793
</entry><entry
794
 align="char">
795
<para>Enables or disables the decoding of the current Audio
796
 stream in the DVB subsystem.</para>
797
</entry>
798
 </row><row><entry
799
 align="char">
800
</entry><entry
801
 align="char">
802
<para>TRUE Bypass is disabled</para>
803
</entry>
804
 </row><row><entry
805
 align="char">
806
</entry><entry
807
 align="char">
808
<para>FALSE Bypass is enabled</para>
809
</entry>
810
 </row></tbody></tgroup></informaltable>
811
<para>ERRORS
812
</para>
813
<informaltable><tgroup cols="2"><tbody><row><entry
814
 align="char">
815
<para>EBADF</para>
816
</entry><entry
817
 align="char">
818
<para>fd is not a valid open file descriptor.</para>
819
</entry>
820
 </row><row><entry
821
 align="char">
822
<para>EINTERNAL</para>
823
</entry><entry
824
 align="char">
825
<para>Internal error.</para>
826
</entry>
827
 </row><row><entry
828
 align="char">
829
<para>EINVAL</para>
830
</entry><entry
831
 align="char">
832
<para>Illegal input parameter.</para>
833
</entry>
834
 </row></tbody></tgroup></informaltable>
835

836
</section><section
837
role="subsection"><title>AUDIO_CHANNEL_SELECT</title>
838
<para>DESCRIPTION
839
</para>
840
<informaltable><tgroup cols="1"><tbody><row><entry
841
 align="char">
842
<para>This ioctl call asks the Audio Device to select the requested channel if possible.</para>
843
</entry>
844
 </row></tbody></tgroup></informaltable>
845
<para>SYNOPSIS
846
</para>
847
<informaltable><tgroup cols="1"><tbody><row><entry
848
 align="char">
849
<para>int ioctl(int fd, int request =
850
 AUDIO_CHANNEL_SELECT, audio_channel_select_t);</para>
851
</entry>
852
 </row></tbody></tgroup></informaltable>
853
<para>PARAMETERS
854
</para>
855
<informaltable><tgroup cols="2"><tbody><row><entry
856
 align="char">
857
<para>int fd</para>
858
</entry><entry
859
 align="char">
860
<para>File descriptor returned by a previous call to open().</para>
861
</entry>
862
 </row><row><entry
863
 align="char">
864
<para>int request</para>
865
</entry><entry
866
 align="char">
867
<para>Equals AUDIO_CHANNEL_SELECT for this
868
 command.</para>
869
</entry>
870
 </row><row><entry
871
 align="char">
872
<para>audio_channel_select_t
873
 ch</para>
874
</entry><entry
875
 align="char">
876
<para>Select the output format of the audio (mono left/right,
877
 stereo).</para>
878
</entry>
879
 </row></tbody></tgroup></informaltable>
880
<para>ERRORS
881
</para>
882
<informaltable><tgroup cols="2"><tbody><row><entry
883
 align="char">
884
<para>EBADF</para>
885
</entry><entry
886
 align="char">
887
<para>fd is not a valid open file descriptor.</para>
888
</entry>
889
 </row><row><entry
890
 align="char">
891
<para>EINTERNAL</para>
892
</entry><entry
893
 align="char">
894
<para>Internal error.</para>
895
</entry>
896
 </row><row><entry
897
 align="char">
898
<para>EINVAL</para>
899
</entry><entry
900
 align="char">
901
<para>Illegal input parameter ch.</para>
902
</entry>
903
 </row></tbody></tgroup></informaltable>
904

905
</section><section
906
role="subsection"><title>AUDIO_GET_STATUS</title>
907
<para>DESCRIPTION
908
</para>
909
<informaltable><tgroup cols="1"><tbody><row><entry
910
 align="char">
911
<para>This ioctl call asks the Audio Device to return the current state of the Audio
912
 Device.</para>
913
</entry>
914
 </row></tbody></tgroup></informaltable>
915
<para>SYNOPSIS
916
</para>
917
<informaltable><tgroup cols="1"><tbody><row><entry
918
 align="char">
919
<para>int ioctl(int fd, int request = AUDIO_GET_STATUS,
920
 struct audio_status &#x22C6;status);</para>
921
</entry>
922
 </row></tbody></tgroup></informaltable>
923
<para>PARAMETERS
924
</para>
925
<informaltable><tgroup cols="2"><tbody><row><entry
926
 align="char">
927
<para>int fd</para>
928
</entry><entry
929
 align="char">
930
<para>File descriptor returned by a previous call to open().</para>
931
</entry>
932
 </row><row><entry
933
 align="char">
934
<para>int request</para>
935
</entry><entry
936
 align="char">
937
<para>Equals AUDIO_GET_STATUS for this command.</para>
938
</entry>
939
 </row><row><entry
940
 align="char">
941
<para>struct audio_status
942
 *status</para>
943
</entry><entry
944
 align="char">
945
<para>Returns the current state of Audio Device.</para>
946
</entry>
947
 </row></tbody></tgroup></informaltable>
948
<para>ERRORS
949
</para>
950
<informaltable><tgroup cols="2"><tbody><row><entry
951
 align="char">
952
<para>EBADF</para>
953
</entry><entry
954
 align="char">
955
<para>fd is not a valid open file descriptor.</para>
956
</entry>
957
 </row><row><entry
958
 align="char">
959
<para>EINTERNAL</para>
960
</entry><entry
961
 align="char">
962
<para>Internal error.</para>
963
</entry>
964
 </row><row><entry
965
 align="char">
966
<para>EFAULT</para>
967
</entry><entry
968
 align="char">
969
<para>status points to invalid address.</para>
970
</entry>
971
 </row></tbody></tgroup></informaltable>
972

973
</section><section
974
role="subsection"><title>AUDIO_GET_CAPABILITIES</title>
975
<para>DESCRIPTION
976
</para>
977
<informaltable><tgroup cols="1"><tbody><row><entry
978
 align="char">
979
<para>This ioctl call asks the Audio Device to tell us about the decoding capabilities
980
 of the audio hardware.</para>
981
</entry>
982
 </row></tbody></tgroup></informaltable>
983
<para>SYNOPSIS
984
</para>
985
<informaltable><tgroup cols="1"><tbody><row><entry
986
 align="char">
987
<para>int ioctl(int fd, int request =
988
 AUDIO_GET_CAPABILITIES, unsigned int &#x22C6;cap);</para>
989
</entry>
990
 </row></tbody></tgroup></informaltable>
991
<para>PARAMETERS
992
</para>
993
<informaltable><tgroup cols="2"><tbody><row><entry
994
 align="char">
995
<para>int fd</para>
996
</entry><entry
997
 align="char">
998
<para>File descriptor returned by a previous call to open().</para>
999
</entry>
1000
 </row><row><entry
1001
 align="char">
1002
<para>int request</para>
1003
</entry><entry
1004
 align="char">
1005
<para>Equals AUDIO_GET_CAPABILITIES for this
1006
 command.</para>
1007
</entry>
1008
 </row><row><entry
1009
 align="char">
1010
<para>unsigned int *cap</para>
1011
</entry><entry
1012
 align="char">
1013
<para>Returns a bit array of supported sound formats.</para>
1014
</entry>
1015
 </row></tbody></tgroup></informaltable>
1016
<para>ERRORS
1017
</para>
1018
<informaltable><tgroup cols="2"><tbody><row><entry
1019
 align="char">
1020
<para>EBADF</para>
1021
</entry><entry
1022
 align="char">
1023
<para>fd is not a valid open file descriptor.</para>
1024
</entry>
1025
 </row><row><entry
1026
 align="char">
1027
<para>EINTERNAL</para>
1028
</entry><entry
1029
 align="char">
1030
<para>Internal error.</para>
1031
</entry>
1032
 </row><row><entry
1033
 align="char">
1034
<para>EFAULT</para>
1035
</entry><entry
1036
 align="char">
1037
<para>cap points to an invalid address.</para>
1038
</entry>
1039
 </row></tbody></tgroup></informaltable>
1040

1041
</section><section
1042
role="subsection"><title>AUDIO_CLEAR_BUFFER</title>
1043
<para>DESCRIPTION
1044
</para>
1045
<informaltable><tgroup cols="1"><tbody><row><entry
1046
 align="char">
1047
<para>This ioctl call asks the Audio Device to clear all software and hardware buffers
1048
 of the audio decoder device.</para>
1049
</entry>
1050
 </row></tbody></tgroup></informaltable>
1051
<para>SYNOPSIS
1052
</para>
1053
<informaltable><tgroup cols="1"><tbody><row><entry
1054
 align="char">
1055
<para>int ioctl(int fd, int request = AUDIO_CLEAR_BUFFER);</para>
1056
</entry>
1057
 </row></tbody></tgroup></informaltable>
1058
<para>PARAMETERS
1059
</para>
1060
<informaltable><tgroup cols="2"><tbody><row><entry
1061
 align="char">
1062
<para>int fd</para>
1063
</entry><entry
1064
 align="char">
1065
<para>File descriptor returned by a previous call to open().</para>
1066
</entry>
1067
 </row><row><entry
1068
 align="char">
1069
<para>int request</para>
1070
</entry><entry
1071
 align="char">
1072
<para>Equals AUDIO_CLEAR_BUFFER for this command.</para>
1073
</entry>
1074
 </row></tbody></tgroup></informaltable>
1075
<para>ERRORS
1076
</para>
1077
<informaltable><tgroup cols="2"><tbody><row><entry
1078
 align="char">
1079
<para>EBADF</para>
1080
</entry><entry
1081
 align="char">
1082
<para>fd is not a valid open file descriptor.</para>
1083
</entry>
1084
 </row><row><entry
1085
 align="char">
1086
<para>EINTERNAL</para>
1087
</entry><entry
1088
 align="char">
1089
<para>Internal error.</para>
1090
</entry>
1091
 </row></tbody></tgroup></informaltable>
1092

1093
</section><section
1094
role="subsection"><title>AUDIO_SET_ID</title>
1095
<para>DESCRIPTION
1096
</para>
1097
<informaltable><tgroup cols="1"><tbody><row><entry
1098
 align="char">
1099
<para>This ioctl selects which sub-stream is to be decoded if a program or system
1100
 stream is sent to the video device. If no audio stream type is set the id has to be
1101
 in [0xC0,0xDF] for MPEG sound, in [0x80,0x87] for AC3 and in [0xA0,0xA7]
1102
 for LPCM. More specifications may follow for other stream types. If the stream
1103
 type is set the id just specifies the substream id of the audio stream and only
1104
 the first 5 bits are recognized.</para>
1105
</entry>
1106
 </row></tbody></tgroup></informaltable>
1107
<para>SYNOPSIS
1108
</para>
1109
<informaltable><tgroup cols="1"><tbody><row><entry
1110
 align="char">
1111
<para>int ioctl(int fd, int request = AUDIO_SET_ID, int
1112
 id);</para>
1113
</entry>
1114
 </row></tbody></tgroup></informaltable>
1115
<para>PARAMETERS
1116
</para>
1117
<informaltable><tgroup cols="2"><tbody><row><entry
1118
 align="char">
1119
<para>int fd</para>
1120
</entry><entry
1121
 align="char">
1122
<para>File descriptor returned by a previous call to open().</para>
1123
</entry>
1124
 </row><row><entry
1125
 align="char">
1126
<para>int request</para>
1127
</entry><entry
1128
 align="char">
1129
<para>Equals AUDIO_SET_ID for this command.</para>
1130
</entry>
1131
 </row><row><entry
1132
 align="char">
1133
<para>int id</para>
1134
</entry><entry
1135
 align="char">
1136
<para>audio sub-stream id</para>
1137
</entry>
1138
 </row></tbody></tgroup></informaltable>
1139
<para>ERRORS
1140
</para>
1141
<informaltable><tgroup cols="2"><tbody><row><entry
1142
 align="char">
1143
<para>EBADF</para>
1144
</entry><entry
1145
 align="char">
1146
<para>fd is not a valid open file descriptor.</para>
1147
</entry>
1148
 </row><row><entry
1149
 align="char">
1150
<para>EINTERNAL</para>
1151
</entry><entry
1152
 align="char">
1153
<para>Internal error.</para>
1154
</entry>
1155
 </row><row><entry
1156
 align="char">
1157
<para>EINVAL</para>
1158
</entry><entry
1159
 align="char">
1160
<para>Invalid sub-stream id.</para>
1161
</entry>
1162
 </row></tbody></tgroup></informaltable>
1163

1164
</section><section
1165
role="subsection"><title>AUDIO_SET_MIXER</title>
1166
<para>DESCRIPTION
1167
</para>
1168
<informaltable><tgroup cols="1"><tbody><row><entry
1169
 align="char">
1170
<para>This ioctl lets you adjust the mixer settings of the audio decoder.</para>
1171
</entry>
1172
 </row></tbody></tgroup></informaltable>
1173
<para>SYNOPSIS
1174
</para>
1175
<informaltable><tgroup cols="1"><tbody><row><entry
1176
 align="char">
1177
<para>int ioctl(int fd, int request = AUDIO_SET_MIXER,
1178
 audio_mixer_t &#x22C6;mix);</para>
1179
</entry>
1180
 </row></tbody></tgroup></informaltable>
1181
<para>PARAMETERS
1182
</para>
1183
<informaltable><tgroup cols="2"><tbody><row><entry
1184
 align="char">
1185
<para>int fd</para>
1186
</entry><entry
1187
 align="char">
1188
<para>File descriptor returned by a previous call to open().</para>
1189
</entry>
1190
 </row><row><entry
1191
 align="char">
1192
<para>int request</para>
1193
</entry><entry
1194
 align="char">
1195
<para>Equals AUDIO_SET_ID for this command.</para>
1196
</entry>
1197
 </row><row><entry
1198
 align="char">
1199
<para>audio_mixer_t *mix</para>
1200
</entry><entry
1201
 align="char">
1202
<para>mixer settings.</para>
1203
</entry>
1204
 </row></tbody></tgroup></informaltable>
1205
<para>ERRORS
1206
</para>
1207
<informaltable><tgroup cols="2"><tbody><row><entry
1208
 align="char">
1209
<para>EBADF</para>
1210
</entry><entry
1211
 align="char">
1212
<para>fd is not a valid open file descriptor.</para>
1213
</entry>
1214
 </row><row><entry
1215
 align="char">
1216
<para>EINTERNAL</para>
1217
</entry><entry
1218
 align="char">
1219
<para>Internal error.</para>
1220
</entry>
1221
 </row><row><entry
1222
 align="char">
1223
<para>EFAULT</para>
1224
</entry><entry
1225
 align="char">
1226
<para>mix points to an invalid address.</para>
1227
</entry>
1228
 </row></tbody></tgroup></informaltable>
1229

1230
</section><section
1231
role="subsection"><title>AUDIO_SET_STREAMTYPE</title>
1232
<para>DESCRIPTION
1233
</para>
1234
<informaltable><tgroup cols="1"><tbody><row><entry
1235
 align="char">
1236
<para>This ioctl tells the driver which kind of audio stream to expect. This is useful
1237
 if the stream offers several audio sub-streams like LPCM and AC3.</para>
1238
</entry>
1239
 </row></tbody></tgroup></informaltable>
1240
<para>SYNOPSIS
1241
</para>
1242
<informaltable><tgroup cols="1"><tbody><row><entry
1243
 align="char">
1244
<para>int ioctl(fd, int request = AUDIO_SET_STREAMTYPE,
1245
 int type);</para>
1246
</entry>
1247
 </row></tbody></tgroup></informaltable>
1248
<para>PARAMETERS
1249
</para>
1250
<informaltable><tgroup cols="2"><tbody><row><entry
1251
 align="char">
1252
<para>int fd</para>
1253
</entry><entry
1254
 align="char">
1255
<para>File descriptor returned by a previous call to open().</para>
1256
</entry>
1257
 </row><row><entry
1258
 align="char">
1259
<para>int request</para>
1260
</entry><entry
1261
 align="char">
1262
<para>Equals AUDIO_SET_STREAMTYPE for this
1263
 command.</para>
1264
</entry>
1265
 </row><row><entry
1266
 align="char">
1267
<para>int type</para>
1268
</entry><entry
1269
 align="char">
1270
<para>stream type</para>
1271
</entry>
1272
 </row></tbody></tgroup></informaltable>
1273
<para>ERRORS
1274
</para>
1275
<informaltable><tgroup cols="2"><tbody><row><entry
1276
 align="char">
1277
<para>EBADF</para>
1278
</entry><entry
1279
 align="char">
1280
<para>fd is not a valid open file descriptor</para>
1281
</entry>
1282
 </row><row><entry
1283
 align="char">
1284
<para>EINVAL</para>
1285
</entry><entry
1286
 align="char">
1287
<para>type is not a valid or supported stream type.</para>
1288
</entry>
1289
 </row></tbody></tgroup></informaltable>
1290

1291
</section><section
1292
role="subsection"><title>AUDIO_SET_EXT_ID</title>
1293
<para>DESCRIPTION
1294
</para>
1295
<informaltable><tgroup cols="1"><tbody><row><entry
1296
 align="char">
1297
<para>This ioctl can be used to set the extension id for MPEG streams in DVD
1298
 playback. Only the first 3 bits are recognized.</para>
1299
</entry>
1300
 </row></tbody></tgroup></informaltable>
1301
<para>SYNOPSIS
1302
</para>
1303
<informaltable><tgroup cols="1"><tbody><row><entry
1304
 align="char">
1305
<para>int ioctl(fd, int request = AUDIO_SET_EXT_ID, int
1306
 id);</para>
1307
</entry>
1308
 </row></tbody></tgroup></informaltable>
1309
<para>PARAMETERS
1310
</para>
1311
<informaltable><tgroup cols="2"><tbody><row><entry
1312
 align="char">
1313
<para>int fd</para>
1314
</entry><entry
1315
 align="char">
1316
<para>File descriptor returned by a previous call to open().</para>
1317
</entry>
1318
 </row><row><entry
1319
 align="char">
1320
<para>int request</para>
1321
</entry><entry
1322
 align="char">
1323
<para>Equals AUDIO_SET_EXT_ID for this command.</para>
1324
</entry>
1325
 </row><row><entry
1326
 align="char">
1327
<para>int id</para>
1328
</entry><entry
1329
 align="char">
1330
<para>audio sub_stream_id</para>
1331
</entry>
1332
 </row></tbody></tgroup></informaltable>
1333
<para>ERRORS
1334
</para>
1335
<informaltable><tgroup cols="2"><tbody><row><entry
1336
 align="char">
1337
<para>EBADF</para>
1338
</entry><entry
1339
 align="char">
1340
<para>fd is not a valid open file descriptor</para>
1341
</entry>
1342
 </row><row><entry
1343
 align="char">
1344
<para>EINVAL</para>
1345
</entry><entry
1346
 align="char">
1347
<para>id is not a valid id.</para>
1348
</entry>
1349
 </row></tbody></tgroup></informaltable>
1350

1351
</section><section
1352
role="subsection"><title>AUDIO_SET_ATTRIBUTES</title>
1353
<para>DESCRIPTION
1354
</para>
1355
<informaltable><tgroup cols="1"><tbody><row><entry
1356
 align="char">
1357
<para>This ioctl is intended for DVD playback and allows you to set certain
1358
 information about the audio stream.</para>
1359
</entry>
1360
 </row></tbody></tgroup></informaltable>
1361
<para>SYNOPSIS
1362
</para>
1363
<informaltable><tgroup cols="1"><tbody><row><entry
1364
 align="char">
1365
<para>int ioctl(fd, int request = AUDIO_SET_ATTRIBUTES,
1366
 audio_attributes_t attr );</para>
1367
</entry>
1368
 </row></tbody></tgroup></informaltable>
1369
<para>PARAMETERS
1370
</para>
1371
<informaltable><tgroup cols="2"><tbody><row><entry
1372
 align="char">
1373
<para>int fd</para>
1374
</entry><entry
1375
 align="char">
1376
<para>File descriptor returned by a previous call to open().</para>
1377
</entry>
1378
 </row><row><entry
1379
 align="char">
1380
<para>int request</para>
1381
</entry><entry
1382
 align="char">
1383
<para>Equals AUDIO_SET_ATTRIBUTES for this command.</para>
1384
</entry>
1385
 </row><row><entry
1386
 align="char">
1387
<para>audio_attributes_t
1388
 attr</para>
1389
</entry><entry
1390
 align="char">
1391
<para>audio attributes according to section ??</para>
1392
</entry>
1393
 </row></tbody></tgroup></informaltable>
1394
<para>ERRORS
1395
</para>
1396
<informaltable><tgroup cols="2"><tbody><row><entry
1397
 align="char">
1398
<para>EBADF</para>
1399
</entry><entry
1400
 align="char">
1401
<para>fd is not a valid open file descriptor</para>
1402
</entry>
1403
 </row><row><entry
1404
 align="char">
1405
<para>EINVAL</para>
1406
</entry><entry
1407
 align="char">
1408
<para>attr is not a valid or supported attribute setting.</para>
1409
</entry>
1410
 </row></tbody></tgroup></informaltable>
1411

1412
</section><section
1413
role="subsection"><title>AUDIO_SET_KARAOKE</title>
1414
<para>DESCRIPTION
1415
</para>
1416
<informaltable><tgroup cols="1"><tbody><row><entry
1417
 align="char">
1418
<para>This ioctl allows one to set the mixer settings for a karaoke DVD.</para>
1419
</entry>
1420
 </row></tbody></tgroup></informaltable>
1421
<para>SYNOPSIS
1422
</para>
1423
<informaltable><tgroup cols="1"><tbody><row><entry
1424
 align="char">
1425
<para>int ioctl(fd, int request = AUDIO_SET_STREAMTYPE,
1426
 audio_karaoke_t &#x22C6;karaoke);</para>
1427
</entry>
1428
 </row></tbody></tgroup></informaltable>
1429
<para>PARAMETERS
1430
</para>
1431
<informaltable><tgroup cols="2"><tbody><row><entry
1432
 align="char">
1433
<para>int fd</para>
1434
</entry><entry
1435
 align="char">
1436
<para>File descriptor returned by a previous call to open().</para>
1437
</entry>
1438
 </row><row><entry
1439
 align="char">
1440
<para>int request</para>
1441
</entry><entry
1442
 align="char">
1443
<para>Equals AUDIO_SET_STREAMTYPE for this
1444
 command.</para>
1445
</entry>
1446
 </row><row><entry
1447
 align="char">
1448
<para>audio_karaoke_t
1449
 *karaoke</para>
1450
</entry><entry
1451
 align="char">
1452
<para>karaoke settings according to section ??.</para>
1453
</entry>
1454
 </row></tbody></tgroup></informaltable>
1455
<para>ERRORS
1456
</para>
1457
<informaltable><tgroup cols="2"><tbody><row><entry
1458
 align="char">
1459
<para>EBADF</para>
1460
</entry><entry
1461
 align="char">
1462
<para>fd is not a valid open file descriptor</para>
1463
</entry>
1464
 </row><row><entry
1465
 align="char">
1466
<para>EINVAL</para>
1467
</entry><entry
1468
 align="char">
1469
<para>karaoke is not a valid or supported karaoke setting.</para>
1470
</entry>
1471
 </row></tbody></tgroup></informaltable>
1472
 </section>
1473
</section>
1474

1475
Product

Resources

Company
