Merge branch 'pm-sleep'
[sfrench/cifs-2.6.git] / Documentation / media / uapi / dvb / audio-set-mute.rst
1 .. -*- coding: utf-8; mode: rst -*-
2
3 .. _AUDIO_SET_MUTE:
4
5 ==============
6 AUDIO_SET_MUTE
7 ==============
8
9 Name
10 ----
11
12 AUDIO_SET_MUTE
13
14
15 Synopsis
16 --------
17
18 .. cpp:function:: int  ioctl(int fd, int request = AUDIO_SET_MUTE, boolean state)
19
20
21 Arguments
22 ---------
23
24 .. flat-table::
25     :header-rows:  0
26     :stub-columns: 0
27
28
29     -  .. row 1
30
31        -  int fd
32
33        -  File descriptor returned by a previous call to open().
34
35     -  .. row 2
36
37        -  int request
38
39        -  Equals AUDIO_SET_MUTE for this command.
40
41     -  .. row 3
42
43        -  boolean state
44
45        -  Indicates if audio device shall mute or not.
46
47     -  .. row 4
48
49        -
50        -  TRUE Audio Mute
51
52     -  .. row 5
53
54        -
55        -  FALSE Audio Un-mute
56
57
58 Description
59 -----------
60
61 This ioctl is for DVB devices only. To control a V4L2 decoder use the
62 V4L2 :ref:`VIDIOC_DECODER_CMD` with the
63 ``V4L2_DEC_CMD_START_MUTE_AUDIO`` flag instead.
64
65 This ioctl call asks the audio device to mute the stream that is
66 currently being played.
67
68
69 Return Value
70 ------------
71
72 On success 0 is returned, on error -1 and the ``errno`` variable is set
73 appropriately. The generic error codes are described at the
74 :ref:`Generic Error Codes <gen-errors>` chapter.