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