video-select-source.rst 1.6 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677
  1. .. -*- coding: utf-8; mode: rst -*-
  2. .. _VIDEO_SELECT_SOURCE:
  3. ===================
  4. VIDEO_SELECT_SOURCE
  5. ===================
  6. Name
  7. ----
  8. VIDEO_SELECT_SOURCE
  9. .. attention:: This ioctl is deprecated.
  10. Synopsis
  11. --------
  12. .. c:function:: int ioctl(fd, VIDEO_SELECT_SOURCE, video_stream_source_t source)
  13. :name: VIDEO_SELECT_SOURCE
  14. Arguments
  15. ---------
  16. .. flat-table::
  17. :header-rows: 0
  18. :stub-columns: 0
  19. - .. row 1
  20. - int fd
  21. - File descriptor returned by a previous call to open().
  22. - .. row 2
  23. - int request
  24. - Equals VIDEO_SELECT_SOURCE for this command.
  25. - .. row 3
  26. - video_stream_source_t source
  27. - Indicates which source shall be used for the Video stream.
  28. Description
  29. -----------
  30. This ioctl is for Digital TV devices only. This ioctl was also supported by the
  31. V4L2 ivtv driver, but that has been replaced by the ivtv-specific
  32. ``IVTV_IOC_PASSTHROUGH_MODE`` ioctl.
  33. This ioctl call informs the video device which source shall be used for
  34. the input data. The possible sources are demux or memory. If memory is
  35. selected, the data is fed to the video device through the write command.
  36. .. c:type:: video_stream_source_t
  37. .. code-block:: c
  38. typedef enum {
  39. VIDEO_SOURCE_DEMUX, /* Select the demux as the main source */
  40. VIDEO_SOURCE_MEMORY /* If this source is selected, the stream
  41. comes from the user through the write
  42. system call */
  43. } video_stream_source_t;
  44. Return Value
  45. ------------
  46. On success 0 is returned, on error -1 and the ``errno`` variable is set
  47. appropriately. The generic error codes are described at the
  48. :ref:`Generic Error Codes <gen-errors>` chapter.