18c2ecf20Sopenharmony_ci.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
28c2ecf20Sopenharmony_ci.. c:namespace:: DTV.dmx
38c2ecf20Sopenharmony_ci
48c2ecf20Sopenharmony_ci.. _DMX_START:
58c2ecf20Sopenharmony_ci
68c2ecf20Sopenharmony_ci=========
78c2ecf20Sopenharmony_ciDMX_START
88c2ecf20Sopenharmony_ci=========
98c2ecf20Sopenharmony_ci
108c2ecf20Sopenharmony_ciName
118c2ecf20Sopenharmony_ci----
128c2ecf20Sopenharmony_ci
138c2ecf20Sopenharmony_ciDMX_START
148c2ecf20Sopenharmony_ci
158c2ecf20Sopenharmony_ciSynopsis
168c2ecf20Sopenharmony_ci--------
178c2ecf20Sopenharmony_ci
188c2ecf20Sopenharmony_ci.. c:macro:: DMX_START
198c2ecf20Sopenharmony_ci
208c2ecf20Sopenharmony_ci``int ioctl(int fd, DMX_START)``
218c2ecf20Sopenharmony_ci
228c2ecf20Sopenharmony_ciArguments
238c2ecf20Sopenharmony_ci---------
248c2ecf20Sopenharmony_ci
258c2ecf20Sopenharmony_ci``fd``
268c2ecf20Sopenharmony_ci    File descriptor returned by :c:func:`open()`.
278c2ecf20Sopenharmony_ci
288c2ecf20Sopenharmony_ciDescription
298c2ecf20Sopenharmony_ci-----------
308c2ecf20Sopenharmony_ci
318c2ecf20Sopenharmony_ciThis ioctl call is used to start the actual filtering operation defined
328c2ecf20Sopenharmony_civia the ioctl calls :ref:`DMX_SET_FILTER` or :ref:`DMX_SET_PES_FILTER`.
338c2ecf20Sopenharmony_ci
348c2ecf20Sopenharmony_ciReturn Value
358c2ecf20Sopenharmony_ci------------
368c2ecf20Sopenharmony_ci
378c2ecf20Sopenharmony_ciOn success 0 is returned.
388c2ecf20Sopenharmony_ci
398c2ecf20Sopenharmony_ciOn error -1 is returned, and the ``errno`` variable is set
408c2ecf20Sopenharmony_ciappropriately.
418c2ecf20Sopenharmony_ci
428c2ecf20Sopenharmony_ci.. tabularcolumns:: |p{2.5cm}|p{15.0cm}|
438c2ecf20Sopenharmony_ci
448c2ecf20Sopenharmony_ci.. flat-table::
458c2ecf20Sopenharmony_ci    :header-rows:  0
468c2ecf20Sopenharmony_ci    :stub-columns: 0
478c2ecf20Sopenharmony_ci
488c2ecf20Sopenharmony_ci    -  .. row 1
498c2ecf20Sopenharmony_ci
508c2ecf20Sopenharmony_ci       -  ``EINVAL``
518c2ecf20Sopenharmony_ci
528c2ecf20Sopenharmony_ci       -  Invalid argument, i.e. no filtering parameters provided via the
538c2ecf20Sopenharmony_ci	  :ref:`DMX_SET_FILTER` or :ref:`DMX_SET_PES_FILTER` ioctls.
548c2ecf20Sopenharmony_ci
558c2ecf20Sopenharmony_ci    -  .. row 2
568c2ecf20Sopenharmony_ci
578c2ecf20Sopenharmony_ci       -  ``EBUSY``
588c2ecf20Sopenharmony_ci
598c2ecf20Sopenharmony_ci       -  This error code indicates that there are conflicting requests.
608c2ecf20Sopenharmony_ci	  There are active filters filtering data from another input source.
618c2ecf20Sopenharmony_ci	  Make sure that these filters are stopped before starting this
628c2ecf20Sopenharmony_ci	  filter.
638c2ecf20Sopenharmony_ci
648c2ecf20Sopenharmony_ciThe generic error codes are described at the
658c2ecf20Sopenharmony_ci:ref:`Generic Error Codes <gen-errors>` chapter.
66