162306a36Sopenharmony_ci.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
262306a36Sopenharmony_ci.. c:namespace:: DTV.dmx
362306a36Sopenharmony_ci
462306a36Sopenharmony_ci.. _DMX_START:
562306a36Sopenharmony_ci
662306a36Sopenharmony_ci=========
762306a36Sopenharmony_ciDMX_START
862306a36Sopenharmony_ci=========
962306a36Sopenharmony_ci
1062306a36Sopenharmony_ciName
1162306a36Sopenharmony_ci----
1262306a36Sopenharmony_ci
1362306a36Sopenharmony_ciDMX_START
1462306a36Sopenharmony_ci
1562306a36Sopenharmony_ciSynopsis
1662306a36Sopenharmony_ci--------
1762306a36Sopenharmony_ci
1862306a36Sopenharmony_ci.. c:macro:: DMX_START
1962306a36Sopenharmony_ci
2062306a36Sopenharmony_ci``int ioctl(int fd, DMX_START)``
2162306a36Sopenharmony_ci
2262306a36Sopenharmony_ciArguments
2362306a36Sopenharmony_ci---------
2462306a36Sopenharmony_ci
2562306a36Sopenharmony_ci``fd``
2662306a36Sopenharmony_ci    File descriptor returned by :c:func:`open()`.
2762306a36Sopenharmony_ci
2862306a36Sopenharmony_ciDescription
2962306a36Sopenharmony_ci-----------
3062306a36Sopenharmony_ci
3162306a36Sopenharmony_ciThis ioctl call is used to start the actual filtering operation defined
3262306a36Sopenharmony_civia the ioctl calls :ref:`DMX_SET_FILTER` or :ref:`DMX_SET_PES_FILTER`.
3362306a36Sopenharmony_ci
3462306a36Sopenharmony_ciReturn Value
3562306a36Sopenharmony_ci------------
3662306a36Sopenharmony_ci
3762306a36Sopenharmony_ciOn success 0 is returned.
3862306a36Sopenharmony_ci
3962306a36Sopenharmony_ciOn error -1 is returned, and the ``errno`` variable is set
4062306a36Sopenharmony_ciappropriately.
4162306a36Sopenharmony_ci
4262306a36Sopenharmony_ci.. tabularcolumns:: |p{2.5cm}|p{15.0cm}|
4362306a36Sopenharmony_ci
4462306a36Sopenharmony_ci.. flat-table::
4562306a36Sopenharmony_ci    :header-rows:  0
4662306a36Sopenharmony_ci    :stub-columns: 0
4762306a36Sopenharmony_ci
4862306a36Sopenharmony_ci    -  .. row 1
4962306a36Sopenharmony_ci
5062306a36Sopenharmony_ci       -  ``EINVAL``
5162306a36Sopenharmony_ci
5262306a36Sopenharmony_ci       -  Invalid argument, i.e. no filtering parameters provided via the
5362306a36Sopenharmony_ci	  :ref:`DMX_SET_FILTER` or :ref:`DMX_SET_PES_FILTER` ioctls.
5462306a36Sopenharmony_ci
5562306a36Sopenharmony_ci    -  .. row 2
5662306a36Sopenharmony_ci
5762306a36Sopenharmony_ci       -  ``EBUSY``
5862306a36Sopenharmony_ci
5962306a36Sopenharmony_ci       -  This error code indicates that there are conflicting requests.
6062306a36Sopenharmony_ci	  There are active filters filtering data from another input source.
6162306a36Sopenharmony_ci	  Make sure that these filters are stopped before starting this
6262306a36Sopenharmony_ci	  filter.
6362306a36Sopenharmony_ci
6462306a36Sopenharmony_ciThe generic error codes are described at the
6562306a36Sopenharmony_ci:ref:`Generic Error Codes <gen-errors>` chapter.
66