.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later .. c:namespace:: DTV.dmx

.. _DMX_GET_PES_PIDS:

================ DMX_GET_PES_PIDS

Name

DMX_GET_PES_PIDS

Synopsis

.. c:macro:: DMX_GET_PES_PIDS

int ioctl(fd, DMX_GET_PES_PIDS, __u16 pids[5])

Arguments

fd File descriptor returned by :c:func:open().

pids Array used to store 5 Program IDs.

Description

This ioctl allows to query a DVB device to return the first PID used by audio, video, textext, subtitle and PCR programs on a given service. They're stored as:

======================= ======== ======================================= PID element position content ======================= ======== ======================================= pids[DMX_PES_AUDIO] 0 first audio PID pids[DMX_PES_VIDEO] 1 first video PID pids[DMX_PES_TELETEXT] 2 first teletext PID pids[DMX_PES_SUBTITLE] 3 first subtitle PID pids[DMX_PES_PCR] 4 first Program Clock Reference PID ======================= ======== =======================================

.. note::

A value equal to 0xffff means that the PID was not filled by the
Kernel.

Return Value

On success 0 is returned.

On error -1 is returned, and the errno variable is set appropriately.

The generic error codes are described at the :ref:Generic Error Codes <gen-errors> chapter.