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