ts::T2MIDemux Class Reference

This class analyzes T2-MI (DVB-T2 Modulator Interface) from TS packets. More...

#include <tsT2MIDemux.h>

Inheritance diagram for ts::T2MIDemux:

Collaboration diagram for ts::T2MIDemux:

Public Types
using	SuperClass = AbstractDemux
	Explicit reference to superclass.

Public Member Functions
	T2MIDemux (DuckContext &duck, T2MIHandlerInterface *t2mi_handler=nullptr, const PIDSet &pid_filter=NoPID)
	Constructor.
virtual	~T2MIDemux () override
	Destructor.
virtual void	addPID (PID pid)
	Add one PID to filter.
virtual void	addPIDs (const PIDSet &pids)
	Add several PID's to filter.
int	demuxId () const
	Get the "demux id" value, as previously stored by the application.
virtual void	feedPacket (const TSPacket &pkt) override
	The following method feeds the demux with a TS packet.
virtual bool	hasPID (PID pid) const
	Check if a PID is filtered.
virtual size_t	pidCount () const
	Get the current number of PID's being filtered.
virtual void	removePID (PID pid)
	Remove one PID to filter.
virtual void	reset ()
	Reset the demux.
virtual void	resetPID (PID pid)
	Reset the demuxing context for one single PID.
void	setDemuxId (int id)
	Set some arbitrary "demux id" value.
void	setHandler (T2MIHandlerInterface *h)
	Replace the T2-MI handler.
virtual void	setPIDFilter (const PIDSet &pid_filter)
	Replace the list of PID's to filter.

Protected Member Functions
bool	afterCallingHandler (bool executeDelayedOperations=true)
	Helper for subclass, after invoking an application-defined handler.
void	beforeCallingHandler (PID pid=PID_NULL)
	Helper for subclass, before invoking an application-defined handler.
virtual void	immediateReset () override
	Reset the demux immediately.
virtual void	immediateResetPID (PID pid) override
	Reset the demuxing context for one single PID immediately.

Protected Attributes
DuckContext &	_duck
	The TSDuck execution context is accessible to all subclasses.
PacketCounter	_packet_count = 0
	Number of TS packets in the demultiplexed stream.
PIDSet	_pid_filter {}
	Current set of filtered PID's.

Detailed Description

This class analyzes T2-MI (DVB-T2 Modulator Interface) from TS packets.

TS packets from the outer transport stream are passed one by one to the demux. The signalization is analyzed. Services with at least one T2-MI component are signaled to a handler. A T2-MI component is spotted by the presence of a T2MI_descriptor in the PMT.

The application decides which T2-MI PID's should be demuxed. These PID's can be selected from the beginning or in response to the discovery of T2-MI PID's.

Constructor & Destructor Documentation

T2MIDemux()

ts::T2MIDemux::T2MIDemux ( DuckContext &  duck, T2MIHandlerInterface *  t2mi_handler = nullptr, const PIDSet &  pid_filter = NoPID  )

explicit

Constructor.

Parameters

[in,out]	duck	TSDuck execution context. The reference is kept inside the demux.
[in]	t2mi_handler	The object to invoke when T2-MI information is found.
[in]	pid_filter	The set of T2-MI PID's to demux.

Member Function Documentation

feedPacket()

virtual void ts::T2MIDemux::feedPacket ( const TSPacket &  pkt )

overridevirtual

The following method feeds the demux with a TS packet.

Parameters

[in]

pkt

A TS packet.

Reimplemented from ts::AbstractDemux.

setHandler()

void ts::T2MIDemux::setHandler ( T2MIHandlerInterface *  h )

inline

Replace the T2-MI handler.

Parameters

[in]

h

The new handler.

immediateReset()

virtual void ts::T2MIDemux::immediateReset ( )

overrideprotectedvirtual

Reset the demux immediately.

Reimplemented from ts::AbstractDemux.

immediateResetPID()

virtual void ts::T2MIDemux::immediateResetPID ( PID  pid )

overrideprotectedvirtual

Reset the demuxing context for one single PID immediately.

Parameters

[in]

pid

The PID to reset.

Reimplemented from ts::AbstractDemux.

setPIDFilter()

virtual void ts::AbstractDemux::setPIDFilter ( const PIDSet &  pid_filter )

virtualinherited

Replace the list of PID's to filter.

The method resetPID() is invoked on each removed PID.

Parameters

[in]

pid_filter

The list of PID's to filter.

addPID()

virtual void ts::AbstractDemux::addPID ( PID  pid )

virtualinherited

Add one PID to filter.

Parameters

[in]

pid

The new PID to filter.

Reimplemented in ts::MPEDemux.

addPIDs()

virtual void ts::AbstractDemux::addPIDs ( const PIDSet &  pids )

virtualinherited

Add several PID's to filter.

Parameters

[in]

pids

The list of new PID's to filter.

Reimplemented in ts::MPEDemux.

removePID()

virtual void ts::AbstractDemux::removePID ( PID  pid )

virtualinherited

Remove one PID to filter.

The method resetPID() is invoked on pid.

Parameters

[in]

pid

The PID to no longer filter.

Reimplemented in ts::MPEDemux.

pidCount()

virtual size_t ts::AbstractDemux::pidCount ( ) const

virtualinherited

Get the current number of PID's being filtered.

Returns

The current number of PID's being filtered.

hasPID()

virtual bool ts::AbstractDemux::hasPID ( PID  pid ) const

virtualinherited

Check if a PID is filtered.

Parameters

[in]

pid

The PID to test.

Returns

Tue if pid is filtered.

reset()

virtual void ts::AbstractDemux::reset ( )

virtualinherited

Reset the demux.

Useful when the transport stream changes. The PID filter and the handlers are not modified.

If invoked in an application-handler, the operation is delayed until the handler terminates. For subclass implementers, see beforeCallingHandler() and override immediateReset() instead of reset().

Reimplemented in ts::StandaloneTableDemux.

resetPID()

virtual void ts::AbstractDemux::resetPID ( PID  pid )

virtualinherited

Reset the demuxing context for one single PID.

Forget all previous partially demuxed data on this PID.

If invoked in an application-handler, the operation is delayed until the handler terminates. For subclass implementers, see beforeCallingHandler() and override immediateResetPID() instead of resetPID().

Parameters

[in]

pid

The PID to reset.

Reimplemented in ts::StandaloneTableDemux.

setDemuxId()

void ts::AbstractDemux::setDemuxId ( int  id )

inlineinherited

Set some arbitrary "demux id" value.

This value is chosen and set by the application. It can be retrieved later if a table or section handler is used by several demux. The demux id is not interpreted by the demux, it is only stored for the application. The initial value of a demux id is zero.

Parameters

[in]

id

Application-defined demux id to assign.

demuxId()

int ts::AbstractDemux::demuxId ( ) const

inlineinherited

Get the "demux id" value, as previously stored by the application.

Returns

The application-defined demux id.

beforeCallingHandler()

void ts::AbstractDemux::beforeCallingHandler ( PID  pid = PID_NULL )

protectedinherited

Helper for subclass, before invoking an application-defined handler.

The idea is to protect the integrity of the demux during the execution of an application-defined handler. The handler is invoked in the middle of an operation but the handler may call reset() or resetPID(). Executing the reset in the middle of an operation may be problematic. By using beforeCallingHandler() and afterCallingHandler(), all reset operations in between are delayed after the execution of the handler.

Example:

beforeCallingHandler(pid);
try {
    _handler->handleEvent(*this, pid, ...);
}
catch (...) {
    afterCallingHandler(false);
    throw;
}
afterCallingHandler();

Parameters

[in]

pid

The PID for which the handler will be called. All reset operations on this PID will be delayed until afterCallingHandler().

afterCallingHandler()

bool ts::AbstractDemux::afterCallingHandler ( bool  executeDelayedOperations = true )

protectedinherited

Helper for subclass, after invoking an application-defined handler.

Parameters

[in]

executeDelayedOperations

When true (the default), execute all pending reset operations.

Returns

True if a delayed reset was executed.

See also

beforeCallingHandler()

---

The documentation for this class was generated from the following file:

• tsT2MIDemux.h