vdr  2.0.7
Public Member Functions | Protected Member Functions | Private Member Functions | Private Attributes | Friends | List of all members
cReceiver Class Referenceabstract

#include <receiver.h>

Public Member Functions

 cReceiver (const cChannel *Channel=NULL, int Priority=MINPRIORITY)
 
virtual ~cReceiver ()
 
bool AddPid (int Pid)
 
bool AddPids (const int *Pids)
 
bool AddPids (int Pid1, int Pid2, int Pid3=0, int Pid4=0, int Pid5=0, int Pid6=0, int Pid7=0, int Pid8=0, int Pid9=0)
 
bool SetPids (const cChannel *Channel)
 
tChannelID ChannelID (void)
 
bool IsAttached (void)
 

Protected Member Functions

void Detach (void)
 
virtual void Activate (bool On)
 
virtual void Receive (uchar *Data, int Length)=0
 

Private Member Functions

bool WantsPid (int Pid)
 

Private Attributes

cDevicedevice
 
tChannelID channelID
 
int priority
 
int pids [MAXRECEIVEPIDS]
 
int numPids
 

Friends

class cDevice
 

Detailed Description

Definition at line 17 of file receiver.h.

Constructor & Destructor Documentation

cReceiver::cReceiver ( const cChannel Channel = NULL,
int  Priority = MINPRIORITY 
)

Creates a new receiver for the given Channel with the given Priority.

If Channel is not NULL, its pids are set by a call to SetPids(). Otherwise pids can be added to the receiver by separate calls to the AddPid[s] functions. The total number of PIDs added to a receiver must not exceed MAXRECEIVEPIDS. Priority may be any value in the range MINPRIORITY...MAXPRIORITY. Negative values indicate that this cReceiver may be detached at any time in favor of a timer recording or live viewing (without blocking the cDevice it is attached to).

Definition at line 14 of file receiver.c.

References constrain(), device, MAXPRIORITY, MINPRIORITY, numPids, priority, and SetPids().

cReceiver::~cReceiver ( )
virtual

Definition at line 22 of file receiver.c.

References device, and esyslog.

Member Function Documentation

virtual void cReceiver::Activate ( bool  On)
inlineprotectedvirtual

This function is called just before the cReceiver gets attached to (On == true) and right after it gets detached from (On == false) a cDevice.

It can be used to do things like starting/stopping a thread. It is guaranteed that Receive() will not be called before Activate(true).

Reimplemented in cRecorder, and cTransfer.

Definition at line 28 of file receiver.h.

Referenced by cDevice::AttachReceiver(), and cDevice::Detach().

bool cReceiver::AddPid ( int  Pid)

Adds the given Pid to the list of PIDs of this receiver.

Definition at line 32 of file receiver.c.

References dsyslog, MAXRECEIVEPIDS, numPids, and pids.

Referenced by AddPids(), cLiveSubtitle::cLiveSubtitle(), and SetPids().

bool cReceiver::AddPids ( const int *  Pids)

Adds the given zero terminated list of Pids to the list of PIDs of this receiver.

Definition at line 45 of file receiver.c.

References AddPid().

Referenced by SetPids().

bool cReceiver::AddPids ( int  Pid1,
int  Pid2,
int  Pid3 = 0,
int  Pid4 = 0,
int  Pid5 = 0,
int  Pid6 = 0,
int  Pid7 = 0,
int  Pid8 = 0,
int  Pid9 = 0 
)

Adds the given Pids to the list of PIDs of this receiver.

Definition at line 56 of file receiver.c.

References AddPid().

tChannelID cReceiver::ChannelID ( void  )
inline

Definition at line 67 of file receiver.h.

References channelID.

void cReceiver::Detach ( void  )
protected
bool cReceiver::IsAttached ( void  )
inline

Returns true if this receiver is (still) attached to a device.

A receiver may be automatically detached from its device in case the device is needed otherwise, so code that uses a cReceiver should repeatedly check whether it is still attached, and if it isn't, delete it (or take any other appropriate measures).

Definition at line 68 of file receiver.h.

Referenced by cRecordControl::Process().

virtual void cReceiver::Receive ( uchar Data,
int  Length 
)
protectedpure virtual

This function is called from the cDevice we are attached to, and delivers one TS packet from the set of PIDs the cReceiver has requested.

The data packet must be accepted immediately, and the call must return as soon as possible, without any unnecessary delay. Each TS packet will be delivered only ONCE, so the cReceiver must make sure that it will be able to buffer the data if necessary.

Implemented in cRecorder, cLiveSubtitle, and cTransfer.

Referenced by cDevice::Action().

bool cReceiver::SetPids ( const cChannel Channel)

Sets the PIDs of this receiver to those of the given Channel, replacing any previously stored PIDs.

If Channel is NULL, all PIDs will be cleared. Parameters in the Setup may control whether certain types of PIDs (like Dolby Digital, for instance) are actually set. The Channel's ID is stored and can later be retrieved through ChannelID(). The ChannelID is necessary to allow the device that will be used for this receiver to detect and store whether the channel can be decrypted in case this is an encrypted channel.

Definition at line 61 of file receiver.c.

References AddPid(), AddPids(), cChannel::Apids(), channelID, cChannel::Dpids(), cChannel::GetChannelID(), numPids, cChannel::Ppid(), Setup, cChannel::Spids(), cSetup::SupportTeletext, cChannel::Tpid(), and cChannel::Vpid().

Referenced by cReceiver().

bool cReceiver::WantsPid ( int  Pid)
private

Definition at line 76 of file receiver.c.

References numPids, and pids.

Referenced by cDevice::DetachAll().

Friends And Related Function Documentation

friend class cDevice
friend

Definition at line 18 of file receiver.h.

Member Data Documentation

tChannelID cReceiver::channelID
private

Definition at line 21 of file receiver.h.

Referenced by ChannelID(), and SetPids().

cDevice* cReceiver::device
private

Definition at line 20 of file receiver.h.

Referenced by cDevice::AttachReceiver(), cReceiver(), Detach(), cDevice::Detach(), and ~cReceiver().

int cReceiver::numPids
private
int cReceiver::pids[MAXRECEIVEPIDS]
private

Definition at line 23 of file receiver.h.

Referenced by AddPid(), cDevice::AttachReceiver(), cDevice::Detach(), and WantsPid().

int cReceiver::priority
private

Definition at line 22 of file receiver.h.

Referenced by cReceiver().


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