Linux 4.11-rc6
[linux/fpc-iii.git] / Documentation / media / uapi / dvb / video-set-id.rst
blob18f66875ae3f8647118bbc56835e216ef997f867
1 .. -*- coding: utf-8; mode: rst -*-
3 .. _VIDEO_SET_ID:
5 ============
6 VIDEO_SET_ID
7 ============
9 Name
10 ----
12 VIDEO_SET_ID
14 .. attention:: This ioctl is deprecated.
16 Synopsis
17 --------
19 .. c:function:: int ioctl(int fd, VIDEO_SET_ID, int id)
20     :name: VIDEO_SET_ID
23 Arguments
24 ---------
26 .. flat-table::
27     :header-rows:  0
28     :stub-columns: 0
31     -  .. row 1
33        -  int fd
35        -  File descriptor returned by a previous call to open().
37     -  .. row 2
39        -  int request
41        -  Equals VIDEO_SET_ID for this command.
43     -  .. row 3
45        -  int id
47        -  video sub-stream id
50 Description
51 -----------
53 This ioctl selects which sub-stream is to be decoded if a program or
54 system stream is sent to the video device.
57 Return Value
58 ------------
60 On success 0 is returned, on error -1 and the ``errno`` variable is set
61 appropriately. The generic error codes are described at the
62 :ref:`Generic Error Codes <gen-errors>` chapter.
66 .. flat-table::
67     :header-rows:  0
68     :stub-columns: 0
71     -  .. row 1
73        -  ``EINVAL``
75        -  Invalid sub-stream id.