Stream Description. More...

#include <streamdescription.h>

Public Member Functions
	StreamDescription ()
	~StreamDescription ()
void	init (ManagedStreamInterface stream, const ServiceLevelAgreement sla, const cardinal maxPoints, const card64 bwThreshold, const double utThreshold, const double systemDelayTolerance, const bool unlayeredAllocation)
bool	tryAllocation (const ServiceLevelAgreement sla, card64 &totalAvailableBandwidth, card64 classAvailableBandwidthArray, ResourceUtilizationPoint &rup, const card64 bandwidthLimit=(card64)-1)
Public Attributes
ManagedStreamInterface *	Interface
AbstractQoSDescription *	QoSDescription
SessionDescription *	Session
card64	StreamID
cardinal	Layers
cardinal	RUEntries
ResourceUtilizationPoint	RUList [MaxRUEntries]
cardinal	NewLayerClassNumber [RTPConstants::RTPMaxQualityLayers]
card64	NewLayerClassBandwidth [RTPConstants::RTPMaxQualityLayers]
double	NewCostPerSecond
ResourceUtilizationPoint	NewQuality
double	LastUtilization
cardinal	CurrentLayerClassNumber [RTPConstants::RTPMaxQualityLayers]
card64	CurrentLayerClassBandwidth [RTPConstants::RTPMaxQualityLayers]
double	CurrentCostPerSecond
ResourceUtilizationPoint	CurrentQuality
card64	ReservationTimeStamp
double	TotalCost
double	TotalBandwidthUsage
double	TotalUtilization
double	TotalRuntime
cardinal	TotalReservationUpdates
cardinal	PartialRemappings
cardinal	CompleteRemappings
cardinal	Inits
cardinal	BufferFlushes
card64	LastInitDuration
double	ReportedLossRate [RTPConstants::RTPMaxQualityLayers]
double	ReportedJitter [RTPConstants::RTPMaxQualityLayers]
double	MeasuredTransferDelay [TrafficClassValues::MaxValues]
InternetAddress	RoundTripTimeDestination
card64	NextInterval
bool	MaximumReached
bool	UnlayeredAllocation
Private Member Functions
bool	calculatePossibleLayerClassMappings (ResourceUtilizationPoint &rup, const ServiceLevelAgreement sla, const AbstractQoSDescription aqd)

Detailed Description

Stream Description.

This class contains a description of a stream. It is used for the bandwidth manager's remapping algorithm.

Author:: Thomas Dreibholz

Version:: 1.0

Constructor & Destructor Documentation

StreamDescription::StreamDescription ( )

Constructor.

StreamDescription::~StreamDescription ( )

Destructor.

Member Function Documentation

bool StreamDescription::calculatePossibleLayerClassMappings	(	ResourceUtilizationPoint &	rup,
		const ServiceLevelAgreement *	sla,
		const AbstractQoSDescription *	aqd
	)		`[private]`

void StreamDescription::init	(	ManagedStreamInterface *	stream,
		const ServiceLevelAgreement *	sla,
		const cardinal	maxPoints,
		const card64	bwThreshold,
		const double	utThreshold,
		const double	systemDelayTolerance,
		const bool	unlayeredAllocation
	)

Initialize.

Parameters:

stream	ManagedStreamInterface.
sla	Service level agreement.
maxPoints	Maximum number of resource/utilization points for each stream.
bwThreshold	Bandwidth threshold.
utThreshold	Utilization threshold.
systemDelayTolerance	The system's delay tolerance for the buffering optimization.
unlayeredAllocation	True, to use the same DiffServ class for all layers; false otherwise.

bool StreamDescription::tryAllocation	(	const ServiceLevelAgreement *	sla,
		card64 &	totalAvailableBandwidth,
		card64 *	classAvailableBandwidthArray,
		ResourceUtilizationPoint &	rup,
		const card64	bandwidthLimit = `(card64)-1`
	)

Try to allocate given layer bandwidths to a stream. If allocation is successful, the availability references are decremented by the bandwidth allocation. The allocated bandwidths and buffer delays will be stored into the resource/utilization point.

Parameters:

sla	Service level agreement.
totalAvailableBandwidth	Reference to total available bandwidth.
classAvailableBandwidthArray	Available bandwidths for each DiffServ class.
rup	Resource/utilization point to do allocation for.
session	Session of the stream.
bandwidthLimit	Upper bandwidth limit (e.g. the session's maximum bandwidth).

Member Data Documentation

cardinal StreamDescription::BufferFlushes

Number of buffer flushes.

cardinal StreamDescription::CompleteRemappings

Number of complete remappings forced by this stream.

double StreamDescription::CurrentCostPerSecond

Current bandwidth cost per second.

card64 StreamDescription::CurrentLayerClassBandwidth[RTPConstants::RTPMaxQualityLayers]

Current layer's allocated bandwidth currently used.

cardinal StreamDescription::CurrentLayerClassNumber[RTPConstants::RTPMaxQualityLayers]

Layer's allocated DiffServ class number currently used.

ResourceUtilizationPoint StreamDescription::CurrentQuality

Current quality.

cardinal StreamDescription::Inits

Number of init() calls.

See also:: init

ManagedStreamInterface* StreamDescription::Interface

Stream's manager interface.

card64 StreamDescription::LastInitDuration

Duration of last init() call.

double StreamDescription::LastUtilization

Last *complete* remapping's utilization.

cardinal StreamDescription::Layers

Number of layers.

bool StreamDescription::MaximumReached

True, if all following higher bandwidth allocations will fail (no more bandwidth available to achieve higher quality -> no more allocation trials necessary); false otherwise.

double StreamDescription::MeasuredTransferDelay[TrafficClassValues::MaxValues]

Smoothed measured transfer delay from ICMP echo replies for each DiffServ class.

double StreamDescription::NewCostPerSecond

New remapping's bandwidth cost per second.

card64 StreamDescription::NewLayerClassBandwidth[RTPConstants::RTPMaxQualityLayers]

New remapping's layer's allocated bandwidth.

cardinal StreamDescription::NewLayerClassNumber[RTPConstants::RTPMaxQualityLayers]

New remapping's layer's allocated DiffServ class number.

ResourceUtilizationPoint StreamDescription::NewQuality

New remapping's quality.

card64 StreamDescription::NextInterval

Time to next interval in microseconds.