WIP FPC-III support
[linux/fpc-iii.git] / Documentation / userspace-api / media / dvb / audio-pause.rst
blobd37d1ddce4dfd644fae7298ece061fb235186849
1 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
2 .. c:namespace:: DTV.audio
4 .. _AUDIO_PAUSE:
6 ===========
7 AUDIO_PAUSE
8 ===========
10 Name
11 ----
13 AUDIO_PAUSE
15 .. attention:: This ioctl is deprecated
17 Synopsis
18 --------
20 .. c:macro:: AUDIO_PAUSE
22 ``int ioctl(int fd, AUDIO_PAUSE)``
24 Arguments
25 ---------
27 .. flat-table::
28     :header-rows:  0
29     :stub-columns: 0
31     -  .. row 1
33        -  int fd
35        -  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.
44 Return Value
45 ------------
47 On success 0 is returned, on error -1 and the ``errno`` variable is set
48 appropriately. The generic error codes are described at the
49 :ref:`Generic Error Codes <gen-errors>` chapter.