streamdescription.h

Go to the documentation of this file.

// ##########################################################################
// ####                                                                  ####
// ####                    Master Thesis Implementation                  ####
// ####  Management of Layered Variable Bitrate Multimedia Streams over  ####
// ####                  DiffServ with A Priori Knowledge                ####
// ####                                                                  ####
// #### ================================================================ ####
// ####                                                                  ####
// ####                                                                  ####
// #### Stream Description                                               ####
// ####                                                                  ####
// #### Version 1.00  --  February 19, 2001                              ####
// ####                                                                  ####
// #### Copyright (C) 2000/2001 Thomas Dreibholz                         ####
// #### University of Bonn, Department of Computer Science IV            ####
// #### EMail: dreibh@iem.uni-due.de                                     ####
// #### WWW:   https://www.uni-due.de/~be0001/diplom/index.html          ####
// ####                                                                  ####
// ##########################################################################


#ifndef STREAMDESCRIPTION_H
#define STREAMDESCRIPTION_H


#include "system.h"
#include "servicelevelagreement.h"
#include "trafficclassvalues.h"
#include "managedstreaminterface.h"
#include "abstractqosdescription.h"
#include "sessiondescription.h"


namespace Coral {


class StreamDescription
{
   // ====== Constructor/Destructor =========================================
   public:
   StreamDescription();

   ~StreamDescription();


   // ====== Initialization =================================================
   void init(ManagedStreamInterface*      stream,
             const ServiceLevelAgreement* sla,
             const cardinal               maxPoints,
             const card64                 bwThreshold,
             const double                 utThreshold,
             const double                 systemDelayTolerance,
             const bool                   unlayeredAllocation);


   // ====== Layer -> DiffServ class mapping and bandwidth allocation =======
   bool tryAllocation(const ServiceLevelAgreement* sla,
                      card64&                      totalAvailableBandwidth,
                      card64*                      classAvailableBandwidthArray,
                      ResourceUtilizationPoint&    rup,
                      const card64                 bandwidthLimit = (card64)-1);


   // ====== Stream and session information =================================
   ManagedStreamInterface* Interface;

   AbstractQoSDescription* QoSDescription;

   SessionDescription* Session;

   card64 StreamID;

   cardinal Layers;


   // ====== Resource/utilization list ======================================
   static const cardinal MaxRUEntries = 256;

   cardinal RUEntries;

   ResourceUtilizationPoint RUList[MaxRUEntries];


   // ====== Newly allocated bandwidths and classes =========================
   cardinal NewLayerClassNumber[RTPConstants::RTPMaxQualityLayers];

   card64 NewLayerClassBandwidth[RTPConstants::RTPMaxQualityLayers];

   double NewCostPerSecond;

   ResourceUtilizationPoint NewQuality;

   double LastUtilization;


   // ====== Current allocated bandwidths and classes =======================
   cardinal CurrentLayerClassNumber[RTPConstants::RTPMaxQualityLayers];

   card64 CurrentLayerClassBandwidth[RTPConstants::RTPMaxQualityLayers];

   double CurrentCostPerSecond;

   ResourceUtilizationPoint CurrentQuality;

   card64 ReservationTimeStamp;


   // ====== Statistics =====================================================
   double TotalCost;

   double TotalBandwidthUsage;

   double TotalUtilization;

   double TotalRuntime;

   cardinal TotalReservationUpdates;

   cardinal PartialRemappings;

   cardinal CompleteRemappings;

   cardinal Inits;

   cardinal BufferFlushes;

   card64 LastInitDuration;



   // ====== Network quality ================================================
   double ReportedLossRate[RTPConstants::RTPMaxQualityLayers];

   double ReportedJitter[RTPConstants::RTPMaxQualityLayers];

   double MeasuredTransferDelay[TrafficClassValues::MaxValues];


   // ====== Miscellaneous data =============================================
   InternetAddress RoundTripTimeDestination;

   card64 NextInterval;

   bool MaximumReached;

   bool UnlayeredAllocation;


   // ====== Private methods ================================================
   private:
   bool calculatePossibleLayerClassMappings(
           ResourceUtilizationPoint&     rup,
           const ServiceLevelAgreement*  sla,
           const AbstractQoSDescription* aqd);
};


}


#endif