Linux 4.11-rc6
[linux/fpc-iii.git] / Documentation / media / uapi / dvb / audio-pause.rst
blobc7310dffbff2f9b7cfb70e3e052e9ceeb8755633
1 .. -*- coding: utf-8; mode: rst -*-
3 .. _AUDIO_PAUSE:
5 ===========
6 AUDIO_PAUSE
7 ===========
9 Name
10 ----
12 AUDIO_PAUSE
14 .. attention:: This ioctl is deprecated
16 Synopsis
17 --------
19 .. c:function:: int  ioctl(int fd, AUDIO_PAUSE)
20     :name: AUDIO_PAUSE
22 Arguments
23 ---------
25 .. flat-table::
26     :header-rows:  0
27     :stub-columns: 0
30     -  .. row 1
32        -  int fd
34        -  File descriptor returned by a previous call to open().
37 Description
38 -----------
40 This ioctl call suspends the audio stream being played. Decoding and
41 playing are paused. It is then possible to restart again decoding and
42 playing process of the audio stream using AUDIO_CONTINUE command.
45 Return Value
46 ------------
48 On success 0 is returned, on error -1 and the ``errno`` variable is set
49 appropriately. The generic error codes are described at the
50 :ref:`Generic Error Codes <gen-errors>` chapter.