xref: /linux/Documentation/userspace-api/media/dvb/dmx-remove-pid.rst (revision da1d9caf95def6f0320819cf941c9fd1069ba9e1)
1.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
2.. c:namespace:: DTV.dmx
3
4.. _DMX_REMOVE_PID:
5
6==============
7DMX_REMOVE_PID
8==============
9
10Name
11----
12
13DMX_REMOVE_PID
14
15Synopsis
16--------
17
18.. c:macro:: DMX_REMOVE_PID
19
20``int ioctl(fd, DMX_REMOVE_PID, __u16 *pid)``
21
22Arguments
23---------
24
25``fd``
26    File descriptor returned by :c:func:`open()`.
27
28``pid``
29    PID of the PES filter to be removed.
30
31Description
32-----------
33
34This ioctl call allows to remove a PID when multiple PIDs are set on a
35transport stream filter, e. g. a filter previously set up with output
36equal to :c:type:`DMX_OUT_TSDEMUX_TAP <dmx_output>`, created via either
37:ref:`DMX_SET_PES_FILTER` or :ref:`DMX_ADD_PID`.
38
39Return Value
40------------
41
42On success 0 is returned.
43
44On error -1 is returned, and the ``errno`` variable is set
45appropriately.
46
47The generic error codes are described at the
48:ref:`Generic Error Codes <gen-errors>` chapter.
49