Documentation/userspace-api/media/dvb/audio-channel-select.rst

   1 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
   2 .. c:namespace:: DTV.audio
   3
   4 .. _AUDIO_CHANNEL_SELECT:
   5
   6 ====================
   7 AUDIO_CHANNEL_SELECT
   8 ====================
   9
  10 Name
  11 ----
  12
  13 AUDIO_CHANNEL_SELECT
  14
  15 .. attention:: This ioctl is deprecated
  16
  17 Synopsis
  18 --------
  19
  20 .. c:macro:: AUDIO_CHANNEL_SELECT
  21
  22 ``int ioctl(int fd, AUDIO_CHANNEL_SELECT, struct audio_channel_select *select)``
  23
  24 Arguments
  25 ---------
  26
  27 .. flat-table::
  28     :header-rows:  0
  29     :stub-columns: 0
  30
  31     -
  32
  33        -  int fd
  34
  35        -  File descriptor returned by a previous call to open().
  36
  37     -
  38
  39        -  audio_channel_select_t ch
  40
  41        -  Select the output format of the audio (mono left/right, stereo).
  42
  43 Description
  44 -----------
  45
  46 This ioctl is for Digital TV devices only. To control a V4L2 decoder use the
  47 V4L2 ``V4L2_CID_MPEG_AUDIO_DEC_PLAYBACK`` control instead.
  48
  49 This ioctl call asks the Audio Device to select the requested channel if
  50 possible.
  51
  52 Return Value
  53 ------------
  54
  55 On success 0 is returned, on error -1 and the ``errno`` variable is set
  56 appropriately. The generic error codes are described at the
  57 :ref:`Generic Error Codes <gen-errors>` chapter.