Linux 4.8.3
[linux/fpc-iii.git] / Documentation / media / uapi / dvb / audio-set-karaoke.rst
blobb55f8380b9cd442e7d1f57f86219a9e44de78410
1 .. -*- coding: utf-8; mode: rst -*-
3 .. _AUDIO_SET_KARAOKE:
5 =================
6 AUDIO_SET_KARAOKE
7 =================
9 Name
10 ----
12 AUDIO_SET_KARAOKE
15 Synopsis
16 --------
18 .. cpp:function:: int ioctl(fd, int request = AUDIO_SET_KARAOKE, audio_karaoke_t *karaoke)
21 Arguments
22 ---------
24 .. flat-table::
25     :header-rows:  0
26     :stub-columns: 0
29     -  .. row 1
31        -  int fd
33        -  File descriptor returned by a previous call to open().
35     -  .. row 2
37        -  int request
39        -  Equals AUDIO_SET_KARAOKE for this command.
41     -  .. row 3
43        -  audio_karaoke_t \*karaoke
45        -  karaoke settings according to section ??.
48 Description
49 -----------
51 This ioctl allows one to set the mixer settings for a karaoke DVD.
54 Return Value
55 ------------
57 On success 0 is returned, on error -1 and the ``errno`` variable is set
58 appropriately. The generic error codes are described at the
59 :ref:`Generic Error Codes <gen-errors>` chapter.
61 .. flat-table::
62     :header-rows:  0
63     :stub-columns: 0
66     -  .. row 1
68        -  ``EINVAL``
70        -  karaoke is not a valid or supported karaoke setting.