Linux 4.8.3
[linux/fpc-iii.git] / Documentation / media / uapi / dvb / audio-pause.rst
blob9ca263e90c6c21df74dc1f8af4ddbbf7656a9acd
1 .. -*- coding: utf-8; mode: rst -*-
3 .. _AUDIO_PAUSE:
5 ===========
6 AUDIO_PAUSE
7 ===========
9 Name
10 ----
12 AUDIO_PAUSE
15 Synopsis
16 --------
18 .. cpp:function:: int  ioctl(int fd, int request = AUDIO_PAUSE)
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_PAUSE for this command.
42 Description
43 -----------
45 This ioctl call suspends the audio stream being played. Decoding and
46 playing are paused. It is then possible to restart again decoding and
47 playing process of the audio stream using AUDIO_CONTINUE command.
50 Return Value
51 ------------
53 On success 0 is returned, on error -1 and the ``errno`` variable is set
54 appropriately. The generic error codes are described at the
55 :ref:`Generic Error Codes <gen-errors>` chapter.