PtMediaCapabilities.h

Go to the documentation of this file.

//
// Copyright (C) 2004-2006 SIPfoundry Inc.
// Licensed by SIPfoundry under the LGPL license.
//
// Copyright (C) 2004-2006 Pingtel Corp.  All rights reserved.
// Licensed to SIPfoundry under a Contributor Agreement.
//
// $$

#ifndef _PtMediaCapabilities_h_
#define _PtMediaCapabilities_h_

// SYSTEM INCLUDES

// APPLICATION INCLUDES
#include <ptapi/PtDefs.h>
// DEFINES
#define CODEC_DELTA             10
// MACROS
// EXTERNAL FUNCTIONS
// EXTERNAL VARIABLES
// CONSTANTS
// STRUCTS
// TYPEDEFS
// FORWARD DECLARATIONS
class PtAudioCodec;

//:Class short description which may consist of multiple lines (note the ':')
// Class detailed description which may extend to multiple lines
class PtMediaCapabilities
{
/* //////////////////////////// PUBLIC //////////////////////////////////// */
public:

/* ============================ CREATORS ================================== */

   PtMediaCapabilities(PtAudioCodec aAudioCodecs[] = NULL, int numAudioCodecs = 0);
     //:Default constructor
     // This constructor takes an optional array of audio codecs which define
     // the audio capabilities.  Note: the order implies the preference (i.e.
     // the first is prefered over the second, etc.).

   PtMediaCapabilities(const PtMediaCapabilities& rPtMediaCapabilities);
     //:Copy constructor

   virtual
   ~PtMediaCapabilities();
     //:Destructor

/* ============================ MANIPULATORS ============================== */

   PtMediaCapabilities& operator=(const PtMediaCapabilities& rhs);
     //:Assignment operator

/* ============================ ACCESSORS ================================= */

   int getNumAudioCodecs() const;
   //: Get the number of codecs contained in this PtMediaCapabilities object.

   PtBoolean getAudioCodec(int index, PtAudioCodec& codec);
   //: Get the condec contained at the given index

   void addAudioCodec(PtAudioCodec& codec);
   //: Add an audio codec to this PtMediaCapabilities object.
   // Note: the order in which the codecs are added implies the preference
   // (i.e. The first is prefered over the second and so on.).

/* ============================ INQUIRY =================================== */

/* //////////////////////////// PROTECTED ///////////////////////////////// */
protected:

/* //////////////////////////// PRIVATE /////////////////////////////////// */
private:
    int mSizeAudioCodecs;
    int mNumAudioCodecs;
    PtAudioCodec* mAudioCodecs;

};

/* ============================ INLINE METHODS ============================ */

#endif  // _PtMediaCapabilities_h_