0001 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
0002 .. c:namespace:: DTV.dmx
0003
0004 .. _DMX_GET_PES_PIDS:
0005
0006 ================
0007 DMX_GET_PES_PIDS
0008 ================
0009
0010 Name
0011 ----
0012
0013 DMX_GET_PES_PIDS
0014
0015 Synopsis
0016 --------
0017
0018 .. c:macro:: DMX_GET_PES_PIDS
0019
0020 ``int ioctl(fd, DMX_GET_PES_PIDS, __u16 pids[5])``
0021
0022 Arguments
0023 ---------
0024
0025 ``fd``
0026 File descriptor returned by :c:func:`open()`.
0027
0028 ``pids``
0029 Array used to store 5 Program IDs.
0030
0031 Description
0032 -----------
0033
0034 This ioctl allows to query a DVB device to return the first PID used
0035 by audio, video, textext, subtitle and PCR programs on a given service.
0036 They're stored as:
0037
0038 ======================= ======== =======================================
0039 PID element position content
0040 ======================= ======== =======================================
0041 pids[DMX_PES_AUDIO] 0 first audio PID
0042 pids[DMX_PES_VIDEO] 1 first video PID
0043 pids[DMX_PES_TELETEXT] 2 first teletext PID
0044 pids[DMX_PES_SUBTITLE] 3 first subtitle PID
0045 pids[DMX_PES_PCR] 4 first Program Clock Reference PID
0046 ======================= ======== =======================================
0047
0048 .. note::
0049
0050 A value equal to 0xffff means that the PID was not filled by the
0051 Kernel.
0052
0053 Return Value
0054 ------------
0055
0056 On success 0 is returned.
0057
0058 On error -1 is returned, and the ``errno`` variable is set
0059 appropriately.
0060
0061 The generic error codes are described at the
0062 :ref:`Generic Error Codes <gen-errors>` chapter.
