0001 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
0002 .. c:namespace:: DTV.video
0003
0004 .. _VIDEO_SELECT_SOURCE:
0005
0006 ===================
0007 VIDEO_SELECT_SOURCE
0008 ===================
0009
0010 Name
0011 ----
0012
0013 VIDEO_SELECT_SOURCE
0014
0015 .. attention:: This ioctl is deprecated.
0016
0017 Synopsis
0018 --------
0019
0020 .. c:macro:: VIDEO_SELECT_SOURCE
0021
0022 ``int ioctl(fd, VIDEO_SELECT_SOURCE, video_stream_source_t source)``
0023
0024 Arguments
0025 ---------
0026
0027 .. flat-table::
0028 :header-rows: 0
0029 :stub-columns: 0
0030
0031 - .. row 1
0032
0033 - int fd
0034
0035 - File descriptor returned by a previous call to open().
0036
0037 - .. row 2
0038
0039 - int request
0040
0041 - Equals VIDEO_SELECT_SOURCE for this command.
0042
0043 - .. row 3
0044
0045 - video_stream_source_t source
0046
0047 - Indicates which source shall be used for the Video stream.
0048
0049 Description
0050 -----------
0051
0052 This ioctl is for Digital TV devices only. This ioctl was also supported by the
0053 V4L2 ivtv driver, but that has been replaced by the ivtv-specific
0054 ``IVTV_IOC_PASSTHROUGH_MODE`` ioctl.
0055
0056 This ioctl call informs the video device which source shall be used for
0057 the input data. The possible sources are demux or memory. If memory is
0058 selected, the data is fed to the video device through the write command.
0059
0060 .. c:type:: video_stream_source_t
0061
0062 .. code-block:: c
0063
0064 typedef enum {
0065 VIDEO_SOURCE_DEMUX, /* Select the demux as the main source */
0066 VIDEO_SOURCE_MEMORY /* If this source is selected, the stream
0067 comes from the user through the write
0068 system call */
0069 } video_stream_source_t;
0070
0071 Return Value
0072 ------------
0073
0074 On success 0 is returned, on error -1 and the ``errno`` variable is set
0075 appropriately. The generic error codes are described at the
0076 :ref:`Generic Error Codes <gen-errors>` chapter.
