0001 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
0002 .. c:namespace:: DTV.dmx
0003
0004 .. _DMX_START:
0005
0006 =========
0007 DMX_START
0008 =========
0009
0010 Name
0011 ----
0012
0013 DMX_START
0014
0015 Synopsis
0016 --------
0017
0018 .. c:macro:: DMX_START
0019
0020 ``int ioctl(int fd, DMX_START)``
0021
0022 Arguments
0023 ---------
0024
0025 ``fd``
0026 File descriptor returned by :c:func:`open()`.
0027
0028 Description
0029 -----------
0030
0031 This ioctl call is used to start the actual filtering operation defined
0032 via the ioctl calls :ref:`DMX_SET_FILTER` or :ref:`DMX_SET_PES_FILTER`.
0033
0034 Return Value
0035 ------------
0036
0037 On success 0 is returned.
0038
0039 On error -1 is returned, and the ``errno`` variable is set
0040 appropriately.
0041
0042 .. tabularcolumns:: |p{2.5cm}|p{15.0cm}|
0043
0044 .. flat-table::
0045 :header-rows: 0
0046 :stub-columns: 0
0047
0048 - .. row 1
0049
0050 - ``EINVAL``
0051
0052 - Invalid argument, i.e. no filtering parameters provided via the
0053 :ref:`DMX_SET_FILTER` or :ref:`DMX_SET_PES_FILTER` ioctls.
0054
0055 - .. row 2
0056
0057 - ``EBUSY``
0058
0059 - This error code indicates that there are conflicting requests.
0060 There are active filters filtering data from another input source.
0061 Make sure that these filters are stopped before starting this
0062 filter.
0063
0064 The generic error codes are described at the
0065 :ref:`Generic Error Codes <gen-errors>` chapter.
