.. -*- coding: utf-8; mode: rst -*- .. _DMX_GET_PES_PIDS: ================ DMX_GET_PES_PIDS ================ Name ---- DMX_GET_PES_PIDS Synopsis -------- .. c:function:: int ioctl(fd, DMX_GET_PES_PIDS, __u16 pids[5]) :name: DMX_GET_PES_PIDS 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 ` chapter.