0001 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
0002 .. c:namespace:: DTV.audio
0003
0004 .. _AUDIO_SET_ID:
0005
0006 ============
0007 AUDIO_SET_ID
0008 ============
0009
0010 Name
0011 ----
0012
0013 AUDIO_SET_ID
0014
0015 .. attention:: This ioctl is deprecated
0016
0017 Synopsis
0018 --------
0019
0020 .. c:macro:: AUDIO_SET_ID
0021
0022 ``int ioctl(int fd, AUDIO_SET_ID, int id)``
0023
0024 Arguments
0025 ---------
0026
0027 .. flat-table::
0028 :header-rows: 0
0029 :stub-columns: 0
0030
0031 -
0032
0033 - int fd
0034
0035 - File descriptor returned by a previous call to open().
0036
0037 -
0038
0039 - int id
0040
0041 - audio sub-stream id
0042
0043 Description
0044 -----------
0045
0046 This ioctl selects which sub-stream is to be decoded if a program or
0047 system stream is sent to the video device. If no audio stream type is
0048 set the id has to be in [0xC0,0xDF] for MPEG sound, in [0x80,0x87] for
0049 AC3 and in [0xA0,0xA7] for LPCM. More specifications may follow for
0050 other stream types. If the stream type is set the id just specifies the
0051 substream id of the audio stream and only the first 5 bits are
0052 recognized.
0053
0054 Return Value
0055 ------------
0056
0057 On success 0 is returned, on error -1 and the ``errno`` variable is set
0058 appropriately. The generic error codes are described at the
0059 :ref:`Generic Error Codes <gen-errors>` chapter.