dmx-start.rst 1.2 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465
  1. .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
  2. .. c:namespace:: DTV.dmx
  3. .. _DMX_START:
  4. =========
  5. DMX_START
  6. =========
  7. Name
  8. ----
  9. DMX_START
  10. Synopsis
  11. --------
  12. .. c:macro:: DMX_START
  13. ``int ioctl(int fd, DMX_START)``
  14. Arguments
  15. ---------
  16. ``fd``
  17. File descriptor returned by :c:func:`open()`.
  18. Description
  19. -----------
  20. This ioctl call is used to start the actual filtering operation defined
  21. via the ioctl calls :ref:`DMX_SET_FILTER` or :ref:`DMX_SET_PES_FILTER`.
  22. Return Value
  23. ------------
  24. On success 0 is returned.
  25. On error -1 is returned, and the ``errno`` variable is set
  26. appropriately.
  27. .. tabularcolumns:: |p{2.5cm}|p{15.0cm}|
  28. .. flat-table::
  29. :header-rows: 0
  30. :stub-columns: 0
  31. - .. row 1
  32. - ``EINVAL``
  33. - Invalid argument, i.e. no filtering parameters provided via the
  34. :ref:`DMX_SET_FILTER` or :ref:`DMX_SET_PES_FILTER` ioctls.
  35. - .. row 2
  36. - ``EBUSY``
  37. - This error code indicates that there are conflicting requests.
  38. There are active filters filtering data from another input source.
  39. Make sure that these filters are stopped before starting this
  40. filter.
  41. The generic error codes are described at the
  42. :ref:`Generic Error Codes <gen-errors>` chapter.