include/media/demux.h

4  * The Kernel Digital TV Demux kABI defines a driver-internal interface for
5  * registering low-level, hardware specific driver to a hardware independent
64  * enum ts_filter_type - filter type bitmap for dmx_ts_feed.set\(\)
69  * @TS_DECODER:		Send stream to built-in decoder (if present).
81  * struct dmx_ts_feed - Structure that contains a TS feed filter
83  * @is_filtering:	Set to non-zero when filtering in progress
112  * struct dmx_section_filter - Structure that describes a section filter
120  * @parent:	  Back-pointer to struct dmx_section_feed.
139  * struct dmx_section_feed - Structure that contains a section feed filter
141  * @is_filtering:	Set to non-zero when filtering in progress
144  * @check_crc:		If non-zero, check the CRC values of filtered sections.
149  *			be allocated, the function fails with -ENOSPC.
190  * typedef dmx_ts_cb - DVB demux TS filter callback function prototype
229  * TS-level forward error correction (FEC), the Transport_error_indicator
235  * is full and return -EOVERFLOW.
245  * - 0, on success;
247  * - -EOVERFLOW, on buffer overflow.
257  * typedef dmx_section_cb - DVB demux TS filter callback function prototype
303  * DVB Front-End
307  * enum dmx_frontend_source - Used to identify the type of frontend
310  *			the MPEG-TS to be filtered comes from userspace,
322  * struct dmx_frontend - Structure that lists the frontends associated with
325  * @connectivity_list:	List of front-ends that can be connected to a
330  *	media-controller based logic.
338  * MPEG-2 TS Demux
342  * enum dmx_demux_caps - MPEG-2 TS Demux capabilities bitmap
361  * DMX_FE_ENTRY - Casts elements in the list of registered
362  *		  front-ends from the generic type struct list_head
371  * struct dmx_demux - Structure that contains the demux capabilities and
376  * @frontend: Front-end connected to the demux
390  *	-EUSERS, if maximum usage count was reached;
391  *	-EINVAL, on bad parameter.
403  *	-ENODEV, if demux was not in use (e. g. no users);
404  *	-EINVAL, on bad parameter.
408  *	front-end, the demux driver software will read packets from memory.
413  *	case, memory-based filtering has to be implemented entirely in software.
417  *	kernel-space memory.
421  *	-ERESTARTSYS, if mutex lock was interrupted;
422  *	-EINTR, if a signal handling is pending;
423  *	-ENODEV, if demux was removed;
424  *	-EINVAL, on bad parameter.
437  *	-ERESTARTSYS, if mutex lock was interrupted;
438  *	-EBUSY, if no more TS feeds is available;
439  *	-EINVAL, on bad parameter.
450  *	-EINVAL on bad parameter.
468  *	-EBUSY, if no more TS feeds is available;
469  *	-EINVAL, on bad parameter.
481  *	-EINVAL, on bad parameter.
483  * @add_frontend: Registers a connectivity between a demux and a front-end,
485  *	@connect_frontend to use the given front-end as a TS source. The
493  *	The @frontend function parameter contains a pointer to the front-end
497  *	-EINVAL, on bad parameter.
499  * @remove_frontend: Indicates that the given front-end, registered by a call
501  *	demux. The function should be called when a front-end driver or a demux
502  *	driver is removed from the system. If the front-end is in use, the
503  *	function fails with the return value of -EBUSY. After successfully
509  *	The @frontend function parameter contains a pointer to the front-end
513  *	-ENODEV, if the front-end was not found,
514  *	-EINVAL, on bad parameter.
516  * @get_frontends: Provides the APIs of the front-ends that have been
517  *	registered for this demux. Any of the front-ends obtained with this
525  *	It returns a struct list_head pointer to the list of front-end
528  * @connect_frontend: Connects the TS output of the front-end to the input of
529  *	the demux. A demux can only be connected to a front-end registered to
531  *	possible to connect multiple demuxes to the same front-end, depending
532  *	on the capabilities of the HW platform. When not used, the front-end
536  *	The @frontend function parameter contains a pointer to the front-end
540  *	-EINVAL, on bad parameter.
542  * @disconnect_frontend: Disconnects the demux and a front-end previously
548  *	-EINVAL on bad parameter.
558  *	-EINVAL on bad parameter.