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                                               ####
// ####                                                                  ####
// ####           Copyright (C) 1999-2012 by Thomas Dreibholz            ####
// ####                                                                  ####
// #### Contact:                                                         ####
// ####    EMail: dreibh@iem.uni-due.de                                  ####
// ####    WWW:   https://www.nntb.no/~dreibh/rtpaudio                ####
// ####                                                                  ####
// #### ---------------------------------------------------------------- ####
// ####                                                                  ####
// #### This program is free software: you can redistribute it and/or    ####
// #### modify it under the terms of the GNU General Public License as   ####
// #### published by the Free Software Foundation, either version 3 of   ####
// #### the License, or (at your option) any later version.              ####
// ####                                                                  ####
// #### This program is distributed in the hope that it will be useful,  ####
// #### but WITHOUT ANY WARRANTY; without even the implied warranty of   ####
// #### MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the    ####
// #### GNU General Public License for more details.                     ####
// ####                                                                  ####
// #### You should have received a copy of the GNU General Public        ####
// #### License along with this program.  If not, see                    ####
// #### <http://www.gnu.org/licenses/>.                                  ####
// ####                                                                  ####
// ##########################################################################
// $Id: streamdescription.h 1307 2011-12-22 07:36:29Z dreibh $


#ifndef STREAMDESCRIPTION_H
#define STREAMDESCRIPTION_H


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


static const cardinal MaxRUEntries = 256;


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