h323t38.h

Go to the documentation of this file.

/*
 * h323t38.h
 *
 * H.323 T.38 logical channel establishment
 *
 * Open H323 Library
 *
 * Copyright (c) 2001 Equivalence Pty. Ltd.
 *
 * The contents of this file are subject to the Mozilla Public License
 * Version 1.0 (the "License"); you may not use this file except in
 * compliance with the License. You may obtain a copy of the License at
 * http://www.mozilla.org/MPL/
 *
 * Software distributed under the License is distributed on an "AS IS"
 * basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See
 * the License for the specific language governing rights and limitations
 * under the License.
 *
 * The Original Code is Open H323 Library.
 *
 * The Initial Developer of the Original Code is Equivalence Pty. Ltd.
 *
 * Contributor(s): ______________________________________.
 *
 * $Log: h323t38.h,v $
 * Revision 2.7  2005/11/30 13:35:27  csoutheren
 * Changed tags for Doxygen
 *
 * Revision 2.6  2002/11/10 11:33:17  robertj
 * Updated to OpenH323 v1.10.3
 *
 * Revision 2.5  2002/09/16 02:52:35  robertj
 * Added #define so can select if #pragma interface/implementation is used on
 *   platform basis (eg MacOS) rather than compiler, thanks Robert Monaghan.
 *
 * Revision 2.4  2002/09/04 06:01:47  robertj
 * Updated to OpenH323 v1.9.6
 *
 * Revision 2.3  2002/07/01 04:56:31  robertj
 * Updated to OpenH323 v1.9.1
 *
 * Revision 2.2  2002/01/14 06:35:57  robertj
 * Updated to OpenH323 v1.7.9
 *
 * Revision 2.1  2001/08/01 05:08:04  robertj
 * Major changes to H.323 capabilities, uses OpalMediaFormat for base name.
 *
 * Revision 2.0  2001/07/27 15:48:24  robertj
 * Conversion of OpenH323 to Open Phone Abstraction Library (OPAL)
 *
 * Revision 1.14  2002/09/16 01:14:15  robertj
 * Added #define so can select if #pragma interface/implementation is used on
 *   platform basis (eg MacOS) rather than compiler, thanks Robert Monaghan.
 *
 * Revision 1.13  2002/09/03 06:19:37  robertj
 * Normalised the multi-include header prevention ifdef/define symbol.
 *
 * Revision 1.12  2002/08/05 10:03:47  robertj
 * Cosmetic changes to normalise the usage of pragma interface/implementation.
 *
 * Revision 1.11  2002/05/15 23:30:01  robertj
 * Backed out delete of t38 handler, causes race conditions.
 *
 * Revision 1.10  2002/05/15 01:30:49  robertj
 * Added missing delete of t38 handler, thanks thsuk@digitalsis.com.
 * Changed to allow the T.35 information to be adjusted so it will work for
 *    various vendors version of the non-standard capability.
 *
 * Revision 1.9  2002/05/10 05:49:22  robertj
 * Added the max bit rate field to the data channel capability class.
 * Added session ID to the data logical channel class.
 * Added capability for old pre-v3 non-standard T.38.
 *
 * Revision 1.8  2002/01/09 00:21:36  robertj
 * Changes to support outgoing H.245 RequstModeChange.
 *
 * Revision 1.7  2002/01/01 23:27:50  craigs
 * Added CleanupOnTermination functions
 * Thanks to Vyacheslav Frolov
 *
 * Revision 1.6  2001/12/22 01:55:20  robertj
 * Removed vast quatities of redundent code that is done by ancestor class.
 *
 * Revision 1.5  2001/12/14 08:36:36  robertj
 * More implementation of T.38, thanks Adam Lazur
 *
 * Revision 1.4  2001/11/20 03:04:30  robertj
 * Added ability to reuse t38 channels with same session ID.
 *
 * Revision 1.3  2001/11/09 05:39:54  craigs
 * Added initial T.38 support thanks to Adam Lazur
 *
 * Revision 1.2  2001/07/24 02:25:57  robertj
 * Added UDP, dual TCP and single TCP modes to T.38 capability.
 *
 * Revision 1.1  2001/07/17 04:44:29  robertj
 * Partial implementation of T.120 and T.38 logical channels.
 *
 */

#ifndef __OPAL_H323T38_H
#define __OPAL_H323T38_H

#ifdef P_USE_PRAGMA
#pragma interface
#endif


#include <h323/h323caps.h>


class H245_T38FaxProfile;
class OpalT38Protocol;



class H323_T38Capability : public H323DataCapability
{
    PCLASSINFO(H323_T38Capability, H323DataCapability);
  public:
    enum TransportMode {
      e_UDP,
      e_DualTCP,
      e_SingleTCP,
      NumTransportModes
    };

    H323_T38Capability(
      TransportMode mode
    );

    Comparison Compare(const PObject & obj) const;

    virtual PObject * Clone() const;

    virtual unsigned GetSubType() const;

    virtual PString GetFormatName() const;

    virtual H323Channel * CreateChannel(
      H323Connection & connection,    
      H323Channel::Directions dir,    
      unsigned sessionID,             
      const H245_H2250LogicalChannelParameters * param
    ) const;

    virtual BOOL OnSendingPDU(
      H245_DataApplicationCapability & pdu
    ) const;

    virtual BOOL OnSendingPDU(
      H245_DataMode & pdu  
    ) const;

    virtual BOOL OnSendingPDU(
      H245_DataProtocolCapability & proto,  
      H245_T38FaxProfile & profile          
    ) const;

    virtual BOOL OnReceivedPDU(
      const H245_DataApplicationCapability & pdu  
    );

    TransportMode GetTransportMode() const { return mode; }

  protected:
    TransportMode mode;
};


class H323_T38NonStandardCapability : public H323NonStandardDataCapability
{
    PCLASSINFO(H323_T38NonStandardCapability, H323NonStandardDataCapability);
  public:
    H323_T38NonStandardCapability(
      BYTE country = 181,            
      BYTE extension = 0,            
      WORD maufacturer = 18          
    );

    virtual PObject * Clone() const;

    virtual PString GetFormatName() const;

    virtual H323Channel * CreateChannel(
      H323Connection & connection,    
      H323Channel::Directions dir,    
      unsigned sessionID,             
      const H245_H2250LogicalChannelParameters * param
    ) const;
};


class H323_T38Channel : public H323DataChannel
{
    PCLASSINFO(H323_T38Channel, H323DataChannel);
  public:
    H323_T38Channel(
      H323Connection & connection,       
      const H323Capability & capability, 
      Directions direction,              
      unsigned sessionID,                
      H323_T38Capability::TransportMode mode
    );
    ~H323_T38Channel();

    virtual BOOL OnSendingPDU(
      H245_OpenLogicalChannel & openPDU  
    ) const;

    virtual BOOL OnReceivedPDU(
      const H245_OpenLogicalChannel & pdu,    
      unsigned & errorCode                    
    );

    virtual void Close();

    virtual void Receive();

    virtual void Transmit();

    virtual BOOL CreateListener();

    virtual BOOL CreateTransport();

    OpalT38Protocol * GetHandler() const { return t38handler; }

  protected:
    BOOL              usesTCP;
    OpalT38Protocol * t38handler;
};


#endif // __OPAL_H323T38_H

---