PtPhoneRinger.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 _PtPhoneRinger_h_
#define _PtPhoneRinger_h_

// SYSTEM INCLUDES
// APPLICATION INCLUDES
#include "ptapi/PtComponent.h"
#include "os/OsTime.h"
#include "os/OsProtectEventMgr.h"
// DEFINES
// MACROS
// EXTERNAL FUNCTIONS
// EXTERNAL VARIABLES
// CONSTANTS
// STRUCTS
// TYPEDEFS
// FORWARD DECLARATIONS
class TaoClientTask;

//:The PtPhoneRinger class models a phone ringer.

class PtPhoneRinger : public PtComponent
{
/* //////////////////////////// PUBLIC //////////////////////////////////// */
public:

   enum RingerLevel
   {
      OFF    = 0,
      MIDDLE = 5,
      FULL   = 10
   };

/* ============================ CREATORS ================================== */
   PtPhoneRinger();
     //:Default constructor

  PtPhoneRinger(TaoClientTask *pClient);

   PtPhoneRinger(const PtPhoneRinger& rPtPhoneRinger);
     //:Copy constructor (not implemented for this class)

   PtPhoneRinger& operator=(const PtPhoneRinger& rhs);
     //:Assignment operator (not implemented for this class)

   virtual
   ~PtPhoneRinger();
     //:Destructor


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

   virtual PtStatus setRingerInfo(int patternIndex, char* info);
     //:Specifies the information string to associate with the indicated
     //:ringer pattern.
     // The <i>info</i> text string is used to provide additional
     // ringer-related information to the phone system (for example, the
     // sound file to associate with this ringer pattern).

   virtual PtStatus setRingerPattern(int patternIndex);
     //:Sets the ringer pattern given a valid index number.
     // The pattern index should be a number between 0 and the value returned
     // by getMaxRingPatternIndex().

   virtual PtStatus setRingerVolume(int volume);
     //:Sets the ringer volume to a value between OFF and FULL (inclusive).

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

   virtual PtStatus getMaxRingPatternIndex(int& rMaxIndex);
     //:Sets <i>rMaxIndex</i> to the maximum valid ringer pattern index.

   virtual PtStatus getNumberOfRings(int& rNumRingCycles);
     //:Sets <i>rNumRingCycles</i> to the number of complete ring cycles that the ringer has been ringing.

   virtual PtStatus getRingerInfo(int patternIndex, char*& rpInfo);
     //:Sets <i>rpInfo</i> to point to the information text string that is
     //:associated with the specified ringer pattern.

   virtual PtStatus getRingerPattern(int& rPatternIndex);
     //:Sets <i>rPatternIndex</i> to the index of the current ringer pattern.

   virtual PtStatus getRingerVolume(int& rVolume);
     //:Sets <i>rVolume</i> to the current ringer volume level.

//   virtual PtStatus getName(char*& rpName);
     //:Returns the name associated with this component.

//   virtual PtStatus getType(int& rType);
     //:Returns the type associated with this component.

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

   virtual PtStatus isRingerOn(PtBoolean& rIsOn);
     //:Sets <i>rIsOn</i> to FALSE if the ringer is OFF and FALSE otherwise.

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

        TaoClientTask   *mpClient;

        OsTime          mTimeOut;
/* //////////////////////////// PRIVATE /////////////////////////////////// */
private:
        OsProtectEventMgr *mpEventMgr;


};

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

#endif  // _PtPhoneRinger_h_