1.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
2.. c:namespace:: DTV.video
3
4.. _VIDEO_SELECT_SOURCE:
5
6===================
7VIDEO_SELECT_SOURCE
8===================
9
10Name
11----
12
13VIDEO_SELECT_SOURCE
14
15.. attention:: This ioctl is deprecated.
16
17Synopsis
18--------
19
20.. c:macro:: VIDEO_SELECT_SOURCE
21
22``int ioctl(fd, VIDEO_SELECT_SOURCE, video_stream_source_t source)``
23
24Arguments
25---------
26
27.. flat-table::
28    :header-rows:  0
29    :stub-columns: 0
30
31    -  .. row 1
32
33       -  int fd
34
35       -  File descriptor returned by a previous call to open().
36
37    -  .. row 2
38
39       -  int request
40
41       -  Equals VIDEO_SELECT_SOURCE for this command.
42
43    -  .. row 3
44
45       -  video_stream_source_t source
46
47       -  Indicates which source shall be used for the Video stream.
48
49Description
50-----------
51
52This ioctl is for Digital TV devices only. This ioctl was also supported by the
53V4L2 ivtv driver, but that has been replaced by the ivtv-specific
54``IVTV_IOC_PASSTHROUGH_MODE`` ioctl.
55
56This ioctl call informs the video device which source shall be used for
57the input data. The possible sources are demux or memory. If memory is
58selected, the data is fed to the video device through the write command.
59
60.. c:type:: video_stream_source_t
61
62.. code-block:: c
63
64	typedef enum {
65		VIDEO_SOURCE_DEMUX, /* Select the demux as the main source */
66		VIDEO_SOURCE_MEMORY /* If this source is selected, the stream
67				comes from the user through the write
68				system call */
69	} video_stream_source_t;
70
71Return Value
72------------
73
74On success 0 is returned, on error -1 and the ``errno`` variable is set
75appropriately. The generic error codes are described at the
76:ref:`Generic Error Codes <gen-errors>` chapter.
77