vdr  1.7.31
Public Member Functions | Protected Member Functions | Private Member Functions | Private Attributes | Friends | List of all members
cReceiver Class Reference

#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)
 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
void Detach (void)
virtual void Activate (bool On)
virtual void Receive (uchar *Data, int Length)=0

Private Member Functions

bool WantsPid (int Pid)
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 include/vdr/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.

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).

virtual cReceiver::~cReceiver ( )
virtual

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 cTransfer, and cTransfer.

Definition at line 28 of file include/vdr/receiver.h.

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

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 cTransfer, and cTransfer.

Definition at line 28 of file receiver.h.

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::AddPid ( int  Pid)

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

bool cReceiver::AddPids ( const int *  Pids)

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

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.

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 include/vdr/receiver.h.

References channelID.

tChannelID cReceiver::ChannelID ( void  )
inline

Definition at line 67 of file receiver.h.

References channelID.

void cReceiver::Detach ( void  )
protected
void cReceiver::Detach ( void  )
protected

Definition at line 87 of file receiver.c.

References cDevice::Detach(), and device.

Referenced by cLiveSubtitle::~cLiveSubtitle(), and cRecorder::~cRecorder().

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 include/vdr/receiver.h.

References device.

Referenced by cRecordControl::Process().

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.

References device.

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 cLiveSubtitle, cTransfer, and cTransfer.

Referenced by cDevice::Action().

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 cLiveSubtitle, cTransfer, and cTransfer.

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.

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
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

cDevice
friend

Definition at line 18 of file include/vdr/receiver.h.

Member Data Documentation

tChannelID cReceiver::channelID
private

Definition at line 21 of file include/vdr/receiver.h.

Referenced by ChannelID(), and SetPids().

cDevice * cReceiver::device
private
int cReceiver::numPids
private
int cReceiver::pids
private

Definition at line 23 of file include/vdr/receiver.h.

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

int cReceiver::priority
private

Definition at line 22 of file include/vdr/receiver.h.

Referenced by cReceiver().


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