| .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later | |
| .. c:namespace:: DTV.dmx | |
| .. _DMX_START: | |
| ========= | |
| DMX_START | |
| ========= | |
| Name | |
| ---- | |
| DMX_START | |
| Synopsis | |
| -------- | |
| .. c:macro:: DMX_START | |
| ``int ioctl(int fd, DMX_START)`` | |
| Arguments | |
| --------- | |
| ``fd`` | |
| File descriptor returned by :c:func:`open()`. | |
| Description | |
| ----------- | |
| This ioctl call is used to start the actual filtering operation defined | |
| via the ioctl calls :ref:`DMX_SET_FILTER` or :ref:`DMX_SET_PES_FILTER`. | |
| Return Value | |
| ------------ | |
| On success 0 is returned. | |
| On error -1 is returned, and the ``errno`` variable is set | |
| appropriately. | |
| .. tabularcolumns:: |p{2.5cm}|p{15.0cm}| | |
| .. flat-table:: | |
| :header-rows: 0 | |
| :stub-columns: 0 | |
| - .. row 1 | |
| - ``EINVAL`` | |
| - Invalid argument, i.e. no filtering parameters provided via the | |
| :ref:`DMX_SET_FILTER` or :ref:`DMX_SET_PES_FILTER` ioctls. | |
| - .. row 2 | |
| - ``EBUSY`` | |
| - This error code indicates that there are conflicting requests. | |
| There are active filters filtering data from another input source. | |
| Make sure that these filters are stopped before starting this | |
| filter. | |
| The generic error codes are described at the | |
| :ref:`Generic Error Codes <gen-errors>` chapter. |