18c2ecf20Sopenharmony_ci.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
28c2ecf20Sopenharmony_ci.. c:namespace:: DTV.dmx
38c2ecf20Sopenharmony_ci
48c2ecf20Sopenharmony_ci.. _DMX_GET_PES_PIDS:
58c2ecf20Sopenharmony_ci
68c2ecf20Sopenharmony_ci================
78c2ecf20Sopenharmony_ciDMX_GET_PES_PIDS
88c2ecf20Sopenharmony_ci================
98c2ecf20Sopenharmony_ci
108c2ecf20Sopenharmony_ciName
118c2ecf20Sopenharmony_ci----
128c2ecf20Sopenharmony_ci
138c2ecf20Sopenharmony_ciDMX_GET_PES_PIDS
148c2ecf20Sopenharmony_ci
158c2ecf20Sopenharmony_ciSynopsis
168c2ecf20Sopenharmony_ci--------
178c2ecf20Sopenharmony_ci
188c2ecf20Sopenharmony_ci.. c:macro:: DMX_GET_PES_PIDS
198c2ecf20Sopenharmony_ci
208c2ecf20Sopenharmony_ci``int ioctl(fd, DMX_GET_PES_PIDS, __u16 pids[5])``
218c2ecf20Sopenharmony_ci
228c2ecf20Sopenharmony_ciArguments
238c2ecf20Sopenharmony_ci---------
248c2ecf20Sopenharmony_ci
258c2ecf20Sopenharmony_ci``fd``
268c2ecf20Sopenharmony_ci    File descriptor returned by :c:func:`open()`.
278c2ecf20Sopenharmony_ci
288c2ecf20Sopenharmony_ci``pids``
298c2ecf20Sopenharmony_ci    Array used to store 5 Program IDs.
308c2ecf20Sopenharmony_ci
318c2ecf20Sopenharmony_ciDescription
328c2ecf20Sopenharmony_ci-----------
338c2ecf20Sopenharmony_ci
348c2ecf20Sopenharmony_ciThis ioctl allows to query a DVB device to return the first PID used
358c2ecf20Sopenharmony_ciby audio, video, textext, subtitle and PCR programs on a given service.
368c2ecf20Sopenharmony_ciThey're stored as:
378c2ecf20Sopenharmony_ci
388c2ecf20Sopenharmony_ci=======================	========	=======================================
398c2ecf20Sopenharmony_ciPID  element		position	content
408c2ecf20Sopenharmony_ci=======================	========	=======================================
418c2ecf20Sopenharmony_cipids[DMX_PES_AUDIO]	0		first audio PID
428c2ecf20Sopenharmony_cipids[DMX_PES_VIDEO]	1		first video PID
438c2ecf20Sopenharmony_cipids[DMX_PES_TELETEXT]	2		first teletext PID
448c2ecf20Sopenharmony_cipids[DMX_PES_SUBTITLE]	3		first subtitle PID
458c2ecf20Sopenharmony_cipids[DMX_PES_PCR]	4		first Program Clock Reference PID
468c2ecf20Sopenharmony_ci=======================	========	=======================================
478c2ecf20Sopenharmony_ci
488c2ecf20Sopenharmony_ci.. note::
498c2ecf20Sopenharmony_ci
508c2ecf20Sopenharmony_ci	A value equal to 0xffff means that the PID was not filled by the
518c2ecf20Sopenharmony_ci	Kernel.
528c2ecf20Sopenharmony_ci
538c2ecf20Sopenharmony_ciReturn Value
548c2ecf20Sopenharmony_ci------------
558c2ecf20Sopenharmony_ci
568c2ecf20Sopenharmony_ciOn success 0 is returned.
578c2ecf20Sopenharmony_ci
588c2ecf20Sopenharmony_ciOn error -1 is returned, and the ``errno`` variable is set
598c2ecf20Sopenharmony_ciappropriately.
608c2ecf20Sopenharmony_ci
618c2ecf20Sopenharmony_ciThe generic error codes are described at the
628c2ecf20Sopenharmony_ci:ref:`Generic Error Codes <gen-errors>` chapter.
63