Merge tag 'libata-5.10-2020-10-30' of git://git.kernel.dk/linux-block
[linux-2.6-microblaze.git] / Documentation / userspace-api / media / dvb / audio-bilingual-channel-select.rst
1 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
2 .. c:namespace:: DTV.audio
3
4 .. _AUDIO_BILINGUAL_CHANNEL_SELECT:
5
6 ==============================
7 AUDIO_BILINGUAL_CHANNEL_SELECT
8 ==============================
9
10 Name
11 ----
12
13 AUDIO_BILINGUAL_CHANNEL_SELECT
14
15 .. attention:: This ioctl is deprecated
16
17 Synopsis
18 --------
19
20 .. c:macro:: AUDIO_BILINGUAL_CHANNEL_SELECT
21
22 ``int ioctl(int fd, AUDIO_BILINGUAL_CHANNEL_SELECT, struct audio_channel_select *select)``
23
24 Arguments
25 ---------
26
27 .. flat-table::
28     :header-rows:  0
29     :stub-columns: 0
30
31     -
32
33        -  int fd
34
35        -  File descriptor returned by a previous call to open().
36
37     -
38
39        -  audio_channel_select_t ch
40
41        -  Select the output format of the audio (mono left/right, stereo).
42
43 Description
44 -----------
45
46 This ioctl is obsolete. Do not use in new drivers. It has been replaced
47 by the V4L2 ``V4L2_CID_MPEG_AUDIO_DEC_MULTILINGUAL_PLAYBACK`` control
48 for MPEG decoders controlled through V4L2.
49
50 This ioctl call asks the Audio Device to select the requested channel
51 for bilingual streams if possible.
52
53 Return Value
54 ------------
55
56 On success 0 is returned, on error -1 and the ``errno`` variable is set
57 appropriately. The generic error codes are described at the
58 :ref:`Generic Error Codes <gen-errors>` chapter.