D:/Storage/CVS_Head/h323plus/include/h323con.h

/*
 * h323con.h
 *
 * H.323 protocol handler
 *
 * Open H323 Library
 *
 * Copyright (c) 1998-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.
 *
 * Portions of this code were written with the assisance of funding from
 * Vovida Networks, Inc. http://www.vovida.com.
 *
 * Contributor(s): ______________________________________.
 *
 * $Log: h323con.h,v $
 * Revision 1.4  2007/10/16 17:01:33  shorne
 * Various little fixes
 *
 * Revision 1.3  2007/08/20 19:13:27  shorne
 * Added Generic Capability support. Fixed Linux compile errors
 *
 * Revision 1.2  2007/08/08 17:24:58  willamowius
 * fix Linux compile error (gcc 4.1.2)
 *
 * Revision 1.1  2007/08/06 20:50:49  shorne
 * First commit of h323plus
 *
 * Revision 1.101.2.12  2007/08/02 20:08:10  shorne
 * added virtual to GetPartyName
 *
 * Revision 1.101.2.11  2007/07/23 21:47:10  shorne
 * Added QoS GK Reporting
 *
 * Revision 1.101.2.10  2007/07/20 22:03:20  shorne
 * Initial H.350 Support
 *
 * Revision 1.101.2.9  2007/07/19 20:10:27  shorne
 * Changed HAS_AEC to H323_AEC
 *
 * Revision 1.101.2.8  2007/05/23 06:58:01  shorne
 * Nat Support for EP's nested behind same NAT
 *
 * Revision 1.101.2.7  2007/05/01 01:17:52  shorne
 * Fix for NAT support disablement for same NAT
 *
 * Revision 1.101.2.6  2007/03/24 23:39:42  shorne
 * More H.239 work
 *
 * Revision 1.101.2.5  2007/03/18 06:21:38  shorne
 * More tweaks with Multimedia OnHold
 *
 * Revision 1.101.2.4  2007/03/14 08:53:38  shorne
 * Added Video on Hold
 *
 * Revision 1.101.2.3  2007/02/18 17:11:23  shorne
 * Added H.249 Extended UserInput Support
 *
 * Revision 1.101.2.2  2007/02/11 00:45:20  shorne
 * Added ability to disable NAT method on a call by call basis
 *
 * Revision 1.101.2.1  2006/12/23 19:08:02  shorne
 * Plugin video codecs & sundry
 *
 * Revision 1.101  2006/07/06 05:20:18  shorne
 * Added Feature CallEndReason
 *
 * Revision 1.100  2006/06/27 12:35:03  csoutheren
 * Patch 1366328 - Support for H.450.3 divertingLegInformation2
 * Thanks to Norbert Bartalsky
 *
 * Revision 1.99  2006/06/23 20:01:28  shorne
 * More H460 support
 *
 * Revision 1.98  2006/06/23 07:06:04  csoutheren
 * Fixed linux compile
 *
 * Revision 1.97  2006/06/23 06:02:44  csoutheren
 * Added missing declarations for H.224 backport
 *
 * Revision 1.96  2006/05/30 11:14:55  hfriederich
 * Switch from DISABLE_H460 to H323_H460
 *
 * Revision 1.95  2006/05/16 11:41:15  shorne
 * call credit, AEC and H460 support
 *
 * Revision 1.94  2006/04/07 10:24:20  rjongbloed
 * Fixed DevStudio compile errors
 *
 * Revision 1.93  2006/04/06 08:22:17  csoutheren
 * Added support for conference commands
 *
 * Revision 1.92  2006/03/02 07:52:49  csoutheren
 * Ensure prompt close of channels when using aggregation
 * Ensure MonitorCallStatus called when using aggregation
 *
 * Revision 1.91  2006/02/24 04:52:17  csoutheren
 * Fixd problem with H.245 aggregation
 *
 * Revision 1.90  2006/01/26 03:36:51  shorne
 * Add the ability to remove a local input device when placing a call on hold
 *
 * Revision 1.89  2006/01/24 08:15:24  csoutheren
 * Implement outgoing H.225 aggregation, and H.245 aggregation (disabled by default)
 * More testing to do, but this looks good :)
 *
 * Revision 1.88  2006/01/23 05:58:25  csoutheren
 * Working outgoing H.225 aggregation (disabled by default)
 *
 * Revision 1.87  2006/01/20 00:32:24  csoutheren
 * First check-in of signalling aggregation code - incomplete and disabled by default
 *
 * Revision 1.86  2006/01/18 07:46:08  csoutheren
 * Initial version of RTP aggregation (disabled by default)
 *
 * Revision 1.85  2005/12/09 05:20:07  csoutheren
 * Added ability to set explicit Q.931 cause code on call end
 *
 * Revision 1.84  2005/12/06 05:28:55  csoutheren
 * Changed AttachSignalChannel to be virtual
 *
 * Revision 1.83  2005/11/30 13:05:01  csoutheren
 * Changed tags for Doxygen
 *
 * Revision 1.82  2005/11/04 06:41:28  csoutheren
 * Changed PMutex to PTimedMutex
 *
 * Revision 1.81  2005/09/16 08:11:06  csoutheren
 * Added new error code
 * Added override for OnIncomingCall that can set return code
 *
 * Revision 1.80  2005/08/30 08:29:30  csoutheren
 * Added new error code
 *
 * Revision 1.79  2005/08/27 02:14:21  csoutheren
 * Capture time that reverse fast start acknowledge is received
 * Capture time that connect is sent/received
 *
 * Revision 1.78  2005/01/03 14:03:20  csoutheren
 * Added new configure options and ability to disable/enable modules
 *
 * Revision 1.77  2005/01/03 06:25:52  csoutheren
 * Added extensive support for disabling code modules at compile time
 *
 * Revision 1.76  2004/12/08 01:59:22  csoutheren
 * initial support for Transnexus OSP toolkit
 *
 * Revision 1.75  2004/11/22 11:30:42  rjongbloed
 * Added ability to restart H.245 negotiations, thanks Norbert Bartalsky
 *
 * Revision 1.74  2004/09/27 08:25:14  csoutheren
 * Changed in-header documentation for external headers to reflect changes
 * in external RTP interface
 *
 * Revision 1.73  2004/09/07 22:50:55  rjongbloed
 * Changed usage of template function as MSVC6 will not compile it.
 *
 * Revision 1.72  2004/09/03 01:06:09  csoutheren
 * Added initial hooks for H.460 GEF
 * Thanks to Simon Horne and ISVO (Asia) Pte Ltd. for this contribution
 *
 * Revision 1.71  2004/07/13 10:19:40  csoutheren
 * Fixed cut & paste errors in comments
 *
 * Revision 1.70  2004/06/15 03:30:00  csoutheren
 * Added OnSendARQ to allow access to the ARQ message before sent by connection
 *
 * Revision 1.69  2004/04/20 05:24:54  csoutheren
 * Added ability to specify Q.931 DisplayName
 *
 * Revision 1.68  2004/04/13 05:50:50  csoutheren
 * Added function to get access to the connection NAT flag
 *
 * Revision 1.67  2004/04/07 05:31:42  csoutheren
 * Added ability to receive calls from endpoints behind NAT firewalls
 *
 * Revision 1.66  2004/03/04 04:48:29  csoutheren
 * Added virtual keyword to allow overring of capability management functions
 * Added additional response code needed for MCU
 *
 * Revision 1.65  2004/02/26 08:32:47  csoutheren
 * Added release complete codes for MCU
 *
 * Revision 1.64  2003/12/28 02:38:14  csoutheren
 * Added H323EndPoint::OnOutgoingCall
 *
 * Revision 1.63  2003/12/14 10:42:29  rjongbloed
 * Changes for compilability without video support.
 *
 * Revision 1.62  2003/10/27 06:03:38  csoutheren
 * Added support for QoS
 *   Thanks to Henry Harrison of AliceStreet
 *
 * Revision 1.61  2003/10/09 09:47:45  csoutheren
 * Fixed problem with re-opening RTP half-channels under unusual
 * circumstances. Thanks to Damien Sandras
 *
 * Revision 1.60  2003/04/30 00:28:50  robertj
 * Redesigned the alternate credentials in ARQ system as old implementation
 *   was fraught with concurrency issues, most importantly it can cause false
 *   detection of replay attacks taking out an endpoint completely.
 *
 * Revision 1.59  2003/02/12 23:59:22  robertj
 * Fixed adding missing endpoint identifer in SETUP packet when gatekeeper
 * routed, pointed out by Stefan Klein
 * Also fixed correct rutrn of gk routing in IRR packet.
 *
 * Revision 1.58  2002/11/27 06:54:52  robertj
 * Added Service Control Session management as per Annex K/H.323 via RAS
 *   only at this stage.
 * Added H.248 ASN and very primitive infrastructure for linking into the
 *   Service Control Session management system.
 * Added basic infrastructure for Annex K/H.323 HTTP transport system.
 * Added Call Credit Service Control to display account balances.
 *
 * Revision 1.57  2002/11/15 05:17:22  robertj
 * Added facility redirect support without changing the call token for access
 *   to the call. If it gets redirected a new H323Connection object is
 *   created but it looks like the same thing to an application.
 *
 * Revision 1.56  2002/11/13 04:37:23  robertj
 * Added ability to get (and set) Q.931 release complete cause codes.
 *
 * Revision 1.55  2002/11/10 06:17:26  robertj
 * Fixed minor documentation errors.
 *
 * Revision 1.54  2002/11/05 00:24:09  robertj
 * Added function to determine if Q.931 CONNECT sent/received.
 *
 * Revision 1.53  2002/10/31 00:31:47  robertj
 * Enhanced jitter buffer system so operates dynamically between minimum and
 *   maximum values. Altered API to assure app writers note the change!
 *
 * Revision 1.52  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.51  2002/09/03 06:19:36  robertj
 * Normalised the multi-include header prevention ifdef/define symbol.
 *
 * Revision 1.50  2002/08/05 10:03:47  robertj
 * Cosmetic changes to normalise the usage of pragma interface/implementation.
 *
 * Revision 1.49  2002/08/05 05:17:37  robertj
 * Fairly major modifications to support different authentication credentials
 *   in ARQ to the logged in ones on RRQ. For both client and server.
 * Various other H.235 authentication bugs and anomalies fixed on the way.
 *
 * Revision 1.48  2002/07/05 02:22:56  robertj
 * Added support for standard and non-standard T.38 mode change.
 *
 * Revision 1.47  2002/07/04 00:40:31  robertj
 * More H.450.11 call intrusion implementation, thanks Aleksandar Todorovic
 *
 * Revision 1.46  2002/06/22 06:11:30  robertj
 * Fixed bug on sometimes missing received endSession causing 10 second
 *   timeout in connection clean up.
 *
 * Revision 1.45  2002/06/22 05:48:38  robertj
 * Added partial implementation for H.450.11 Call Intrusion
 *
 * Revision 1.44  2002/06/13 06:15:19  robertj
 * Allowed TransferCall() to be used on H323Connection as well as H323EndPoint.
 *
 * Revision 1.43  2002/06/05 08:58:58  robertj
 * Fixed documentation of remote application name string.
 * Added missing virtual keywards on some protocol handler functions.
 *
 * Revision 1.42  2002/05/29 06:40:29  robertj
 * Changed sending of endSession/ReleaseComplete PDU's to occur immediately
 *   on call clearance and not wait for background thread to do it.
 * Stricter compliance by waiting for reply endSession before closing down.
 *
 * Revision 1.41  2002/05/29 03:55:17  robertj
 * Added protocol version number checking infrastructure, primarily to improve
 *   interoperability with stacks that are unforgiving of new features.
 *
 * Revision 1.40  2002/05/21 09:32:49  robertj
 * Added ability to set multiple alias names ona  connection by connection
 *   basis, defaults to endpoint list, thanks Artis Kugevics
 *
 * Revision 1.39  2002/05/15 23:59:33  robertj
 * Added memory management of created T.38 and T.120 handlers.
 * Improved documentation for use of T.38 and T.120 functions.
 * Added ability to initiate a mode change for non-standard T.38
 *
 * Revision 1.38  2002/05/07 01:31:51  dereks
 * Fix typo in documentation.
 *
 * Revision 1.37  2002/05/03 05:38:15  robertj
 * Added Q.931 Keypad IE mechanism for user indications (DTMF).
 *
 * Revision 1.36  2002/05/02 07:56:24  robertj
 * Added automatic clearing of call if no media (RTP data) is transferred in a
 *   configurable (default 5 minutes) amount of time.
 *
 * Revision 1.35  2002/04/25 20:55:25  dereks
 * Fix documentation. Thanks Olaf Schulz.
 *
 * Revision 1.34  2002/04/17 00:50:34  robertj
 * Added ability to disable the in band DTMF detection.
 *
 * Revision 1.33  2002/03/27 06:04:42  robertj
 * Added Temporary Failure end code for connection, an application may
 *   immediately retry the call if this occurs.
 *
 * Revision 1.32  2002/02/11 04:20:48  robertj
 * Fixed documentation errors, thanks Horacio J. Peña
 *
 * Revision 1.31  2002/02/11 04:16:37  robertj
 * Fixed bug where could send DRQ if never received an ACF.
 *
 * Revision 1.30  2002/02/06 06:30:47  craigs
 * Fixed problem whereby MSD/TCS was stalled if H245 was included in
 * SETUP, but other end did not respond
 *
 * Revision 1.29  2002/02/04 07:17:52  robertj
 * Added H.450.2 Consultation Transfer, thanks Norwood Systems.
 *
 * Revision 1.28  2002/01/25 05:20:05  robertj
 * Moved static strings for enum printing to inside of function, could crash with DLL's
 *
 * Revision 1.27  2002/01/24 06:29:02  robertj
 * Added option to disable H.245 negotiation in SETUP pdu, this required
 *   API change so have a bit mask instead of a series of booleans.
 *
 * Revision 1.26  2002/01/23 12:45:37  rogerh
 * Add the DTMF decoder. This identifies DTMF tones in an audio stream.
 *
 * Revision 1.25  2002/01/23 07:12:48  robertj
 * Added hooks for in band DTMF detection. Now need the detector!
 *
 * Revision 1.24  2002/01/22 22:48:21  robertj
 * Fixed RFC2833 support (transmitter) requiring large rewrite
 *
 * Revision 1.23  2002/01/18 06:02:08  robertj
 * Added some H323v4 functions (fastConnectRefused & TCS in SETUP)
 *
 * Revision 1.22  2002/01/17 07:04:58  robertj
 * Added support for RFC2833 embedded DTMF in the RTP stream.
 *
 * Revision 1.21  2002/01/14 00:05:24  robertj
 * Added H.450.6, better H.450.2 error handling and  and Music On Hold.
 * Added destExtraCallInfo field for ARQ.
 *   Thanks Ben Madsen of Norwood Systems
 *
 * Revision 1.20  2002/01/10 05:13:50  robertj
 * Added support for external RTP stacks, thanks NuMind Software Systems.
 *
 * Revision 1.19  2002/01/09 00:21:36  robertj
 * Changes to support outgoing H.245 RequstModeChange.
 *
 * Revision 1.18  2001/12/22 03:20:31  robertj
 * Added create protocol function to H323Connection.
 *
 * Revision 1.17  2001/12/22 03:09:36  robertj
 * Changed OnRequstModeChange to return ack, then actually do the change.
 *
 * Revision 1.16  2001/12/22 01:52:54  robertj
 * Added more support for H.245 RequestMode operation.
 *
 * Revision 1.15  2001/12/15 08:09:54  robertj
 * Added alerting, connect and end of call times to be sent to RAS server.
 *
 * Revision 1.14  2001/12/13 10:54:23  robertj
 * Added ability to automatically add ACF access token to SETUP pdu.
 *
 * Revision 1.13  2001/11/01 06:11:54  robertj
 * Plugged very small mutex hole that could cause crashes.
 *
 * Revision 1.12  2001/11/01 00:27:33  robertj
 * Added default Fast Start disabled and H.245 tunneling disable flags
 *   to the endpoint instance.
 *
 * Revision 1.11  2001/10/24 00:54:13  robertj
 * Made cosmetic changes to H.245 miscellaneous command function.
 *
 * Revision 1.10  2001/10/23 02:18:06  dereks
 * Initial release of CU30 video codec.
 *
 * Revision 1.9  2001/09/26 06:20:56  robertj
 * Fixed properly nesting connection locking and unlocking requiring a quite
 *   large change to teh implementation of how calls are answered.
 *
 * Revision 1.8  2001/09/19 03:30:53  robertj
 * Added some support for overlapped dialing, thanks Chris Purvis & Nick Hoath.
 *
 * Revision 1.7  2001/09/13 06:48:13  robertj
 * Added call back functions for remaining Q.931/H.225 messages.
 * Added call back to allow modification of Release Complete,thanks Nick Hoath
 *
 * Revision 1.6  2001/09/12 06:57:58  robertj
 * Added support for iNow Access Token from gk, thanks Nick Hoath
 *
 * Revision 1.5  2001/09/12 06:04:36  robertj
 * Added support for sending UUIE's to gk on request, thanks Nick Hoath
 *
 * Revision 1.4  2001/09/11 01:24:36  robertj
 * Added conditional compilation to remove video and/or audio codecs.
 *
 * Revision 1.3  2001/08/22 06:54:50  robertj
 * Changed connection locking to use double mutex to guarantee that
 *   no threads can ever deadlock or access deleted connection.
 *
 * Revision 1.2  2001/08/16 07:49:16  robertj
 * Changed the H.450 support to be more extensible. Protocol handlers
 *   are now in separate classes instead of all in H323Connection.
 *
 * Revision 1.1  2001/08/06 03:08:11  robertj
 * Fission of h323.h to h323ep.h & h323con.h, h323.h now just includes files.
 *
 */

#ifndef __OPAL_H323CON_H
#define __OPAL_H323CON_H

#ifdef P_USE_PRAGMA
#pragma interface
#endif

#ifdef P_DTMF
#include <ptclib/dtmf.h>
#endif

#include "h323caps.h"
#include "transports.h"
#include "channels.h"
#include "guid.h"
#include "openh323buildopts.h"
#include "h235auth.h"

#if H323_H224
class OpalH224Handler;
class OpalH281Handler;
#endif

#ifdef H323_SIGNAL_AGGREGATE
#include <ptclib/sockagg.h>

class H323AggregatedH2x5Handle : public PAggregatedHandle
{
  PCLASSINFO(H323AggregatedH2x5Handle, PAggregatedHandle)
  public:
    H323AggregatedH2x5Handle(H323Transport & _transport, H323Connection & _connection);
    ~H323AggregatedH2x5Handle();

    PAggregatorFDList_t GetFDs();

    BOOL OnRead();
    virtual BOOL HandlePDU(BOOL ok, PBYTEArray & pdu) = 0;
    PTimeInterval GetTimeout()
    { return transport.GetReadTimeout(); }

  protected:
    PAggregatorFD fd;
    H323Transport & transport;
    H323Connection & connection;
    PBYTEArray pduBuffer;
    PINDEX pduDataLen;
};

#endif

#ifdef H323_H248
 #include "svcctrl.h"
#endif


/* The following classes have forward references to avoid including the VERY
   large header files for H225 and H245. If an application requires access
   to the protocol classes they can include them, but for simple usage their
   inclusion can be avoided.
 */
class PPER_Stream;

class H225_EndpointType;
class H225_TransportAddress;
class H225_ArrayOf_PASN_OctetString;
class H225_ProtocolIdentifier;
class H225_AdmissionRequest;
class H225_AdmissionReject;
class H225_AdmissionConfirm;
class H225_InfoRequestResponse;
class H225_DisengageRequest;
class H225_FeatureSet;
class H225_Setup_UUIE;
class H225_ArrayOf_ServiceControlSession;
class H225_ServiceControlSession_reason;

class H245_TerminalCapabilitySet;
class H245_TerminalCapabilitySetReject;
class H245_OpenLogicalChannel;
class H245_OpenLogicalChannelAck;
class H245_TransportAddress;
class H245_UserInputIndication;
class H245_RequestMode;
class H245_RequestModeAck;
class H245_RequestModeReject;
class H245_ModeDescription;
class H245_ArrayOf_ModeDescription;
class H245_SendTerminalCapabilitySet;
class H245_MultiplexCapability;
class H245_FlowControlCommand;
class H245_MiscellaneousCommand;
class H245_MiscellaneousIndication;
class H245_JitterIndication;
class H245_ConferenceRequest;
class H245_ConferenceResponse;
class H245_ConferenceCommand;
class H245_ConferenceIndication;
class H245_GenericMessage;
class H245_ArrayOf_GenericParameter;

class H323SignalPDU;
class H323ControlPDU;
class H323_RTP_UDP;

class H235Authenticators;

class H245NegMasterSlaveDetermination;
class H245NegTerminalCapabilitySet;
class H245NegLogicalChannels;
class H245NegRequestMode;
class H245NegRoundTripDelay;

#ifdef H323_H450

class H450xDispatcher;
class H4502Handler;
class H4503Handler;
class H4504Handler;
class H4506Handler;
class H45011Handler;

#endif

#ifdef H323_T120
class OpalT120Protocol;
#endif

#ifdef H323_T38
class OpalT38Protocol;
#endif

#ifdef H323_H224
class OpalH224Handler;
class OpalH281Handler;
#endif

class OpalRFC2833;
class OpalRFC2833Info;

#ifdef H323_H460
class H460_FeatureSet;
#endif



class H323Connection : public PObject
{
  PCLASSINFO(H323Connection, PObject);

  friend class AggregatedH225Handle;
  friend class AggregatedH245Handle;
  public:
    enum Options {
      FastStartOptionDisable       = 0x0001,
      FastStartOptionEnable        = 0x0002,
      FastStartOptionMask          = 0x0003,

      H245TunnelingOptionDisable   = 0x0004,
      H245TunnelingOptionEnable    = 0x0008,
      H245TunnelingOptionMask      = 0x000c,

      H245inSetupOptionDisable     = 0x0010,
      H245inSetupOptionEnable      = 0x0020,
      H245inSetupOptionMask        = 0x0030,

      DetectInBandDTMFOptionDisable= 0x0040,
      DetectInBandDTMFOptionEnable = 0x0080,
      DetectInBandDTMFOptionMask   = 0x00c0,

#ifdef H323_RTP_AGGREGATE
      RTPAggregationDisable        = 0x0100,
      RTPAggregationEnable         = 0x0200,
      RTPAggregationMask           = 0x0300,
#endif

#ifdef H323_SIGNAL_AGGREGATE
      SignallingAggregationDisable = 0x0400,
      SignallingAggregationEnable  = 0x0800,
      SignallingAggregationMask    = 0x0c00
#endif
    };

    H323Connection(
      H323EndPoint & endpoint,  
      unsigned callReference,   
      unsigned options = 0      
    );

    ~H323Connection();

    BOOL Lock();

    int TryLock();

    void Unlock();

    virtual void OnSendARQ(
      H225_AdmissionRequest & arq
    );

    virtual void OnReceivedACF(
      const H225_AdmissionConfirm & acf
    );

    virtual void OnReceivedARJ(
      const H225_AdmissionReject & arj
    );

    virtual void OnSendIRR(
                H225_InfoRequestResponse & irr
        ) const;

    virtual void OnSendDRQ(
                H225_DisengageRequest & drq
        ) const;

    virtual void OnEstablished();

    virtual void OnCleared();

    BOOL IsConnected() const { return connectionState == HasExecutedSignalConnect || connectionState == EstablishedConnection; }

    BOOL IsEstablished() const { return connectionState == EstablishedConnection; }

    enum CallEndReason {
      EndedByLocalUser,         
      EndedByNoAccept,          
      EndedByAnswerDenied,      
      EndedByRemoteUser,        
      EndedByRefusal,           
      EndedByNoAnswer,          
      EndedByCallerAbort,       
      EndedByTransportFail,     
      EndedByConnectFail,       
      EndedByGatekeeper,        
      EndedByNoUser,            
      EndedByNoBandwidth,       
      EndedByCapabilityExchange,
      EndedByCallForwarded,     
      EndedBySecurityDenial,    
      EndedByLocalBusy,         
      EndedByLocalCongestion,   
      EndedByRemoteBusy,        
      EndedByRemoteCongestion,  
      EndedByUnreachable,       
      EndedByNoEndPoint,        
      EndedByHostOffline,       
      EndedByTemporaryFailure,  
      EndedByQ931Cause,         
      EndedByDurationLimit,     
      EndedByInvalidConferenceID, 
      EndedByOSPRefusal,          
      EndedByInvalidNumberFormat, 
      EndedByUnspecifiedProtocolError, 
      EndedByNoFeatureSupport,         
      NumCallEndReasons
    };
#if PTRACING
    friend ostream & operator<<(ostream & o, CallEndReason r);
#endif

    CallEndReason GetCallEndReason() const { return callEndReason; }

    virtual void SetCallEndReason(
      CallEndReason reason,     
      PSyncPoint * sync = NULL  
    );

    virtual BOOL ClearCall(
      CallEndReason reason = EndedByLocalUser  
    );

    virtual BOOL ClearCallSynchronous(
      PSyncPoint * sync,
      CallEndReason reason = EndedByLocalUser  
    );

    virtual void CleanUpOnCallEnd();


    virtual void AttachSignalChannel(
      const PString & token,    
      H323Transport * channel,  
      BOOL answeringCall        
    );

    BOOL WriteSignalPDU(
      H323SignalPDU & pdu       
    );

    virtual void HandleSignallingChannel();

    virtual BOOL HandleReceivedSignalPDU(BOOL readStatus, H323SignalPDU & pdu);

    virtual BOOL HandleReceivedControlPDU(BOOL readStatus, PPER_Stream & strm);

    virtual BOOL HandleSignalPDU(
      H323SignalPDU & pdu       
    );

    virtual void HandleTunnelPDU(
      H323SignalPDU * txPDU       
    );

    virtual BOOL OnReceivedSignalSetup(
      const H323SignalPDU & pdu   
    );

    virtual BOOL OnReceivedSignalSetupAck(
      const H323SignalPDU & pdu   
    );

    virtual BOOL OnReceivedSignalInformation(
      const H323SignalPDU & pdu   
    );

    virtual BOOL OnReceivedCallProceeding(
      const H323SignalPDU & pdu   
    );

    virtual BOOL OnReceivedProgress(
      const H323SignalPDU & pdu   
    );

    virtual BOOL OnReceivedAlerting(
      const H323SignalPDU & pdu   
    );

    virtual BOOL OnReceivedSignalConnect(
      const H323SignalPDU & pdu   
    );

    virtual BOOL OnReceivedFacility(
      const H323SignalPDU & pdu   
    );

    virtual BOOL OnReceivedSignalNotify(
      const H323SignalPDU & pdu   
    );

    virtual BOOL OnReceivedSignalStatus(
      const H323SignalPDU & pdu   
    );

    virtual BOOL OnReceivedStatusEnquiry(
      const H323SignalPDU & pdu   
    );

    virtual void OnReceivedReleaseComplete(
      const H323SignalPDU & pdu   
    );

    virtual BOOL OnUnknownSignalPDU(
      const H323SignalPDU & pdu  
    );

    virtual BOOL OnIncomingCall(
      const H323SignalPDU & setupPDU,   
      H323SignalPDU & alertingPDU       
    );
    virtual BOOL OnIncomingCall(
      const H323SignalPDU & setupPDU,   
      H323SignalPDU & alertingPDU,      
      CallEndReason & reason            
    );

    virtual BOOL ForwardCall(
      const PString & forwardParty   
    );

#ifdef H323_H450

    void TransferCall(
      const PString & remoteParty,   
      const PString & callIdentity = PString::Empty()
    );

    void ConsultationTransfer(
      const PString & primaryCallToken  
    );

    virtual void OnReceivedInitiateReturnError();

    virtual void HandleConsultationTransfer(
      const PString & callIdentity, 
      H323Connection & incoming     
    );

    BOOL IsTransferringCall() const;

    BOOL IsTransferredCall() const;

    virtual void HandleTransferCall(
      const PString & token,
      const PString & identity
    );

    int GetCallTransferInvokeId();

    virtual void HandleCallTransferFailure(
      const int returnError    
    );

    void SetAssociatedCallToken(
      const PString & token  
    );

    virtual void OnConsultationTransferSuccess(
      H323Connection & secondaryCall  
    );

     virtual void SetCallLinkage(
                H225_AdmissionRequest & arq   
      );

     virtual void GetCallLinkage(
                const H225_AdmissionRequest & arq  
        );

    BOOL GetRedirectingNumber(
      PString &originalCalledNr,               
      PString &lastDivertingNr,
      int &divCounter, 
      int &originaldivReason,
      int &divReason);

    void HoldCall(
      BOOL localHold   
    );

    void RetrieveCall();

    void SetHoldMedia(
      PChannel * audioChannel
    );

    void SetVideoHoldMedia(
          PChannel * videoChannel
        );

    virtual PChannel *  OnCallHold(BOOL IsEncoder,     
                               unsigned sessionId,     
                               unsigned bufferSize,    
                               PChannel * channel);    

    virtual PChannel *  OnCallRetrieve(BOOL IsEncoder,  
                               unsigned sessionId,      
                               unsigned bufferSize,     
                               PChannel * channel);     

    BOOL IsMediaOnHold() const;

    BOOL IsLocalHold() const;

    BOOL IsRemoteHold() const;

    BOOL IsCallOnHold() const;

    virtual void IntrudeCall(
      unsigned capabilityLevel
    );

    virtual void HandleIntrudeCall(
      const PString & token,
      const PString & identity
    );

    void SetCallIntrusion() { isCallIntrusion = TRUE; }

    BOOL IsCallIntrusion() { return isCallIntrusion; }

    unsigned GetLocalCallIntrusionProtectionLevel() { return callIntrusionProtectionLevel; }

    virtual BOOL GetRemoteCallIntrusionProtectionLevel(
      const PString & callToken,
      unsigned callIntrusionProtectionLevel
    );

    virtual void SetIntrusionImpending();

    virtual void SetForcedReleaseAccepted();

    virtual void SetIntrusionNotAuthorized();

    void SendCallWaitingIndication(
      const unsigned nbOfAddWaitingCalls = 0   
    );

#endif // H323_H450

    enum AnswerCallResponse {
      AnswerCallNow,               
      AnswerCallDenied,            
      AnswerCallPending,           
      AnswerCallDeferred,          
      AnswerCallAlertWithMedia,    
      AnswerCallDeferredWithMedia, 
      AnswerCallDeniedByInvalidCID, 
      NumAnswerCallResponses
    };
#if PTRACING
    friend ostream & operator<<(ostream & o, AnswerCallResponse s);
#endif

    virtual AnswerCallResponse OnAnswerCall(
      const PString & callerName,       
      const H323SignalPDU & setupPDU,   
      H323SignalPDU & connectPDU        
    );

    void AnsweringCall(
      AnswerCallResponse response 
    );

    virtual CallEndReason SendSignalSetup(
      const PString & alias,                
      const H323TransportAddress & address  
    );

    virtual BOOL OnSendSignalSetup(
      H323SignalPDU & setupPDU   
    );

    virtual BOOL OnSendCallProceeding(
      H323SignalPDU & callProceedingPDU   
    );

    virtual BOOL OnSendReleaseComplete(
      H323SignalPDU & releaseCompletePDU 
    );

    virtual BOOL OnAlerting(
      const H323SignalPDU & alertingPDU,  
      const PString & user                
    );

    virtual BOOL OnInsufficientDigits();

    virtual void SendMoreDigits(
      const PString & digits    
    );

    virtual BOOL OnOutgoingCall(
      const H323SignalPDU & connectPDU   
    );

    virtual BOOL SendFastStartAcknowledge(
      H225_ArrayOf_PASN_OctetString & array   
    );

    virtual BOOL HandleFastStartAcknowledge(
      const H225_ArrayOf_PASN_OctetString & array   
    );

    virtual BOOL StartControlChannel();

    virtual BOOL StartControlChannel(
      const H225_TransportAddress & h245Address   
    );

    BOOL WriteControlPDU(
      const H323ControlPDU & pdu
    );

    virtual BOOL StartControlNegotiations(
      BOOL renegotiate = FALSE  
    );

    virtual void HandleControlChannel();

    virtual BOOL HandleControlData(
      PPER_Stream & strm
    );

    virtual BOOL HandleControlPDU(
      const H323ControlPDU & pdu
    );

    virtual BOOL OnUnknownControlPDU(
      const H323ControlPDU & pdu  
    );

    virtual BOOL OnH245Request(
      const H323ControlPDU & pdu  
    );

    virtual BOOL OnH245Response(
      const H323ControlPDU & pdu  
    );

    virtual BOOL OnH245Command(
      const H323ControlPDU & pdu  
    );

    virtual BOOL OnH245Indication(
      const H323ControlPDU & pdu  
    );

    virtual BOOL OnH245_SendTerminalCapabilitySet(
      const H245_SendTerminalCapabilitySet & pdu  
    );

    virtual BOOL OnH245_FlowControlCommand(
      const H245_FlowControlCommand & pdu  
    );

    virtual BOOL OnH245_MiscellaneousCommand(
      const H245_MiscellaneousCommand & pdu  
    );

    virtual BOOL OnH245_MiscellaneousIndication(
      const H245_MiscellaneousIndication & pdu  
    );

    virtual BOOL OnH245_JitterIndication(
      const H245_JitterIndication & pdu  
    );

    enum ControlProtocolErrors {
      e_MasterSlaveDetermination,
      e_CapabilityExchange,
      e_LogicalChannel,
      e_ModeRequest,
      e_RoundTripDelay
    };

    virtual BOOL OnControlProtocolError(
      ControlProtocolErrors errorSource,  
      const void * errorData = NULL       
    );

    virtual void OnSendCapabilitySet(
      H245_TerminalCapabilitySet & pdu  
    );

    virtual BOOL OnReceivedCapabilitySet(
      const H323Capabilities & remoteCaps,      
      const H245_MultiplexCapability * muxCap,  
      H245_TerminalCapabilitySetReject & reject 
    );

    virtual void SendCapabilitySet(
      BOOL empty  
    );

    virtual void OnSetLocalCapabilities();

    BOOL IsH245Master() const;

    void StartRoundTripDelay();

    PTimeInterval GetRoundTripDelay() const;

    virtual void OnSelectLogicalChannels();

    virtual void SelectDefaultLogicalChannel(
      unsigned sessionID    
    );

    virtual void SelectFastStartChannels(
      unsigned sessionID,   
      BOOL transmitter,     
      BOOL receiver         
    );

    void DisableFastStart();

    virtual BOOL OpenLogicalChannel(
      const H323Capability & capability,  
      unsigned sessionID,                 
      H323Channel::Directions dir         
    );

    virtual BOOL OnOpenLogicalChannel(
      const H245_OpenLogicalChannel & openPDU,  
      H245_OpenLogicalChannelAck & ackPDU,      
      unsigned & errorCode                      
    );

    virtual BOOL OnConflictingLogicalChannel(
      H323Channel & channel    
    );

    virtual H323Channel * CreateLogicalChannel(
      const H245_OpenLogicalChannel & open, 
      BOOL startingFast,                    
      unsigned & errorCode                  
    );

    virtual H323Channel * CreateRealTimeLogicalChannel(
      const H323Capability & capability, 
      H323Channel::Directions dir,       
      unsigned sessionID,                
      const H245_H2250LogicalChannelParameters * param,
      RTP_QOS * rtpqos = NULL            
    );

    virtual BOOL OnCreateLogicalChannel(
      const H323Capability & capability,  
      H323Channel::Directions dir,        
      unsigned & errorCode                
    );

    virtual BOOL OnStartLogicalChannel(
      H323Channel & channel    
    );

#ifndef NO_H323_AUDIO_CODECS

    virtual BOOL OpenAudioChannel(
      BOOL isEncoding,       
      unsigned bufferSize,   
      H323AudioCodec & codec 
    );
#endif

#ifndef NO_H323_VIDEO

    virtual BOOL OpenVideoChannel(
      BOOL isEncoding,       
      H323VideoCodec & codec 
    );

#ifdef H323_H239

    virtual BOOL OpenExtendedVideoSession(
                    unsigned role,                     
                    H323ChannelNumber & channelnum     
        );

        virtual void OnReceivedExtendedVideoSession(
                   unsigned /*role*/,                           
                   const H323ChannelNumber & /*channelnum*/     
        ) const {};
    
    virtual void CloseExtendedVideoSession(
       const H323ChannelNumber & num     
        );

    virtual BOOL OpenExtendedVideoChannel(
      BOOL isEncoding,       
      H323VideoCodec & codec 
    );

#endif // H323_H239

#endif // NO_H323_VIDEO

    virtual void CloseLogicalChannel(
      unsigned number,    
      BOOL fromRemote     
    );

    virtual void CloseLogicalChannelNumber(
      const H323ChannelNumber & number    
    );

    virtual void CloseAllLogicalChannels(
      BOOL fromRemote     
    );

    virtual void OnClosedLogicalChannel(
      const H323Channel & channel   
    );

    virtual BOOL OnClosingLogicalChannel(
      H323Channel & channel   
    );

    virtual void OnLogicalChannelFlowControl(
      H323Channel * channel,   
      long bitRateRestriction  
    );

    virtual void OnLogicalChannelJitter(
      H323Channel * channel,   
      DWORD jitter,            
      int skippedFrameCount,   
      int additionalBuffer     
    );

    void SendLogicalChannelMiscCommand(
      H323Channel & channel,  
      unsigned command        
    );

    H323Channel * GetLogicalChannel(
      unsigned number,    
      BOOL fromRemote     
    ) const;

    H323Channel * FindChannel(
      unsigned sessionId,   
      BOOL fromRemote       
    ) const;

    unsigned GetBandwidthUsed() const;

    BOOL UseBandwidth(
      unsigned bandwidth,     
      BOOL removing           
    );

    unsigned GetBandwidthAvailable() const { return bandwidthAvailable; }

    BOOL SetBandwidthAvailable(
      unsigned newBandwidth,    
      BOOL force = FALSE        
    );

    enum SendUserInputModes {
      SendUserInputAsQ931,
      SendUserInputAsString,
      SendUserInputAsTone,
      SendUserInputAsInlineRFC2833,
      SendUserInputAsSeparateRFC2833,  // Not implemented
#ifdef H323_H249
      SendUserInputAsNavigation,
      SendUserInputAsSoftkey,
      SendUserInputAsPointDevice,
      SendUserInputAsModal,
#endif
      NumSendUserInputModes
    };
#if PTRACING
    friend ostream & operator<<(ostream & o, SendUserInputModes m);
#endif

    void SetSendUserInputMode(SendUserInputModes mode);

    SendUserInputModes GetSendUserInputMode() const { return sendUserInputMode; }

    SendUserInputModes GetRealSendUserInputMode() const;

    virtual void SendUserInput(
      const PString & value                   
    );

    virtual void OnUserInputString(
      const PString & value   
    );

    virtual void SendUserInputTone(
      char tone,                   
      unsigned duration = 0,       
      unsigned logicalChannel = 0, 
      unsigned rtpTimestamp = 0    
    );

    virtual void OnUserInputTone(
      char tone,               
      unsigned duration,       
      unsigned logicalChannel, 
      unsigned rtpTimestamp    
    );

    void SendUserInputHookFlash(
      int duration = 500  
    ) { SendUserInputTone('!', duration); }

    virtual void SendUserInputIndicationQ931(
      const PString & value                   
    );

    virtual void SendUserInputIndicationString(
      const PString & value                   
    );

    virtual void SendUserInputIndicationTone(
      char tone,                   
      unsigned duration = 0,       
      unsigned logicalChannel = 0, 
      unsigned rtpTimestamp = 0    
    );

#ifdef H323_H249

        virtual void SendUserInputIndicationNavigate(
                H323_UserInputCapability::NavigateKeyID keyID
        );

        virtual void OnUserInputIndicationNavigate(
                const H245_ArrayOf_GenericParameter & contents
        );
        
    virtual void SendUserInputIndicationSoftkey(
                unsigned key, 
                const PString & keyName = PString()
        );

    virtual void OnUserInputIndicationSoftkey(
                const H245_ArrayOf_GenericParameter & contents
        );

    virtual void SendUserInputIndicationPointDevice(
                            unsigned x,              
                                                unsigned y,              
                                                unsigned button=0,       
                                                unsigned buttonstate=0,  
                                                unsigned clickcount=0    
    );

    virtual void OnUserInputIndicationPointDevice(
                const H245_ArrayOf_GenericParameter & contents
        );
        
        virtual void SendUserInputIndicationModal();

    virtual void OnUserInputIndicationModal(
                const H245_ArrayOf_GenericParameter & contents
        );
        
#endif


    virtual void SendUserInputIndication(
      const H245_UserInputIndication & pdu    
    );

    virtual void OnUserInputIndication(
      const H245_UserInputIndication & pdu  
    );

    virtual RTP_Session * GetSession(
      unsigned sessionID
    ) const;

    virtual H323_RTP_Session * GetSessionCallbacks(
      unsigned sessionID
    ) const;

    virtual RTP_Session * UseSession(
      unsigned sessionID,
      const H245_TransportAddress & pdu,
      H323Channel::Directions dir,
      RTP_QOS * rtpqos = NULL
    );

    virtual void ReleaseSession(
      unsigned sessionID
    );

        virtual BOOL OnReceiveRTPAltInformation(H323_RTP_UDP & rtp, 
                            const H245_ArrayOf_GenericInformation & alternate) const;

    virtual BOOL OnSendingRTPAltInformation(const H323_RTP_UDP & rtp,
                                        H245_ArrayOf_GenericInformation & alternate) const;


    virtual void OnRTPStatistics(
      const RTP_Session & session   
    ) const;

    virtual void OnRTPFinalStatistics(
      const RTP_Session & session   
    ) const;

    virtual PString GetSessionCodecNames(
      unsigned sessionID
    ) const;

    BOOL IsBehindNAT() const
    { return remoteIsNAT; }

        void SetRemoteNAT()
        { remoteIsNAT = TRUE; }

        BOOL HasNATSupport() const
        { return NATsupport; }

        void DisableNATSupport()
        { NATsupport = FALSE; remoteIsNAT = FALSE; }
        
        void SetSameNAT() { sameNAT = TRUE; };

        BOOL isSameNAT() { return sameNAT; };

    virtual void SetEndpointTypeInfo(H225_EndpointType & info) const;


    virtual BOOL RequestModeChange(
      const PString & newModes  
    );

    virtual BOOL RequestModeChange(
      const H245_ArrayOf_ModeDescription & newModes  
    );

    virtual BOOL OnRequestModeChange(
      const H245_RequestMode & pdu,     
      H245_RequestModeAck & ack,        
      H245_RequestModeReject & reject,  
      PINDEX & selectedMode           
    );

    virtual void OnModeChanged(
      const H245_ModeDescription & newMode
    );

    virtual void OnAcceptModeChange(
      const H245_RequestModeAck & pdu  
    );

    virtual void OnRefusedModeChange(
      const H245_RequestModeReject * pdu  
    );

#ifdef H323_T120

    virtual OpalT120Protocol * CreateT120ProtocolHandler();
#endif

#ifdef H323_T38

    virtual OpalT38Protocol * CreateT38ProtocolHandler();

    virtual BOOL RequestModeChangeT38(
      const char * capabilityNames = "T.38\nT38FaxUDP"
    );
#endif

#ifdef H323_H224

    virtual OpalH224Handler *CreateH224ProtocolHandler(unsigned sessionID);
        
     virtual OpalH281Handler *CreateH281ProtocolHandler(OpalH224Handler & h224Handler);
#endif

    virtual BOOL GetAdmissionRequestAuthentication(
      const H225_AdmissionRequest & arq,  
      H235Authenticators & authenticators 
    );

    H323EndPoint & GetEndPoint() const { return endpoint; }

    BOOL HadAnsweredCall() const { return callAnswered; }

    BOOL IsGatekeeperRouted() const { return gatekeeperRouted; }

    unsigned GetQ931Cause() const { return q931Cause; }

    void SetQ931Cause(unsigned v) { q931Cause = v; }

    unsigned GetDistinctiveRing() const { return distinctiveRing; }

    void SetDistinctiveRing(unsigned pattern) { distinctiveRing = pattern&7; }

    const PString & GetCallToken() const { return callToken; }

    unsigned GetCallReference() const { return callReference; }

    const OpalGloballyUniqueID & GetCallIdentifier() const { return callIdentifier; }

    const OpalGloballyUniqueID & GetConferenceIdentifier() const { return conferenceIdentifier; }

    const PString & GetLocalPartyName() const { return localPartyName; }

    void SetLocalPartyName(const PString & name);

    void SetDisplayName(const PString & name) { localDisplayName = name; }

    const PString GetDisplayName() const { return localDisplayName; }

    const PStringList & GetLocalAliasNames() const { return localAliasNames; }

    virtual const PString & GetRemotePartyName() const { return remotePartyName; }

    const PString & GetRemotePartyNumber() const { return remotePartyNumber; }

    const PString & GetRemotePartyAddress() const { return remotePartyAddress; }

        const PStringArray & GetRemotePartyAliases() const { return remoteAliasNames; }

    void SetRemotePartyInfo(
      const H323SignalPDU & pdu 
    );

    const PString & GetRemoteApplication() const { return remoteApplication; }

    void SetRemoteApplication(
      const H225_EndpointType & pdu 
    );
    
    const H323Capabilities & GetLocalCapabilities() const { return localCapabilities; }

    const H323Capabilities & GetRemoteCapabilities() const { return remoteCapabilities; }

    unsigned GetRemoteMaxAudioDelayJitter() const { return remoteMaxAudioDelayJitter; }

    const H323Transport * GetSignallingChannel() const { return signallingChannel; }

    unsigned GetSignallingVersion() const { return h225version; }

    const H323Transport & GetControlChannel() const;

    unsigned GetControlVersion() const { return h245version; }

    PTime GetSetupUpTime() const { return setupTime; }

    PTime GetAlertingTime() const { return alertingTime; }

    PTime GetConnectionStartTime() const { return connectedTime; }

    PTime GetConnectionEndTime() const { return callEndTime; }

    PTime GetReverseMediaOpenTime() const { return reverseMediaOpenTime; }

    unsigned GetMinAudioJitterDelay() const { return minAudioJitterDelay; }

    unsigned GetMaxAudioJitterDelay() const { return maxAudioJitterDelay; }

    void SetAudioJitterDelay(
      unsigned minDelay,   
      unsigned maxDelay    
    );

    unsigned GetUUIEsRequested() const { return uuiesRequested; }

    void SetUUIEsRequested(unsigned mask) { uuiesRequested = mask; }

    const PString GetGkAccessTokenOID() const { return gkAccessTokenOID; }

    void SetGkAccessTokenOID(const PString & oid) { gkAccessTokenOID = oid; }

    const PBYTEArray & GetGkAccessTokenData() const { return gkAccessTokenData; }

    void SetDestExtraCallInfo(
      const PString & info
    ) { destExtraCallInfo = info; }

    void SetRemoteCallWaiting(const unsigned value) { remoteCallWaiting = value; }

    const int GetRemoteCallWaiting() const { return remoteCallWaiting; }

    void SetEnforcedDurationLimit(
      unsigned seconds  
    );

#ifdef H323_H460

        void DisableFeatures();
#endif

    virtual BOOL OnSendFeatureSet(unsigned, H225_FeatureSet &) const;

    virtual void OnReceiveFeatureSet(unsigned, const H225_FeatureSet &) const;


#ifndef DISABLE_CALLAUTH

    const H235Authenticators & GetEPAuthenticators() const;

    virtual void SetAuthenticationConnection();

    virtual BOOL OnCallAuthentication(const PString & username, 
                                      PString & password);

        virtual BOOL OnEPAuthenticationFailed(H235Authenticator::ValidationResult result) const;

    virtual void OnAuthenticationFinalise(unsigned pdu,PBYTEArray & rawData);

    BOOL HasAuthentication() const
       { return hasAuthentication; }

        BOOL HasAuthenticationFailed() 
           { return AuthenticationFailed; };
#endif

#ifdef H323_H248

    BOOL OnSendServiceControlSessions(
                 H225_ArrayOf_ServiceControlSession & serviceControl, 
                 H225_ServiceControlSession_reason reason           
                ) const;

    void OnReceiveServiceControlSessions(
                const H225_ArrayOf_ServiceControlSession & serviceControl  
                );

    virtual void OnReceiveServiceControl(const PString & amount,    
                                         BOOL credit,               
                                         const unsigned & timelimit,
                                         const PString & url,       
                                                                                 const PString & ldapURL,   
                                                                             const PString & baseDN     
                                                                            );

    virtual BOOL OnSendServiceControl(PString & amount,          
                                      BOOL credit,               
                                      unsigned & timelimit,      
                                      PString & url              
                                                                     ) const;
#endif

    virtual void DisableH245inSETUP();

    virtual void SetNonCallConnection();

#ifdef H323_H460

    virtual H460_FeatureSet * GetFeatureSet();
#endif


    enum ReleaseSequence {
      ReleaseSequenceUnknown,
      ReleaseSequence_Local,
      ReleaseSequence_Remote
    };

    ReleaseSequence GetReleaseSequence() const
    { return releaseSequence; }

    virtual BOOL OnHandleConferenceRequest(const H245_ConferenceRequest &)
    { return FALSE; }

    virtual BOOL OnHandleConferenceResponse(const H245_ConferenceResponse &)
    { return FALSE; }

    virtual BOOL OnHandleConferenceCommand(const H245_ConferenceCommand &)
    { return FALSE; }

    virtual BOOL OnHandleConferenceIndication(const H245_ConferenceIndication &)
    { return FALSE; }

    enum h245MessageType {
      h245request,
      h245response,
      h245command,
          h245indication
    };

        virtual BOOL OnHandleH245GenericMessage(h245MessageType, const H245_GenericMessage &)
        { return FALSE; }

#ifdef H323_H230

        BOOL OpenConferenceControlSession(
                                        BOOL & chairControl,
                                BOOL & extControls
                                                );


#endif

  protected:
    virtual void InternalEstablishedConnectionCheck();
    BOOL DecodeFastStartCaps(const H225_ArrayOf_PASN_OctetString & fastStartCaps);
    BOOL InternalEndSessionCheck(PPER_Stream & strm);
    void SetRemoteVersions(const H225_ProtocolIdentifier & id);
    void MonitorCallStatus();
    PDECLARE_NOTIFIER(OpalRFC2833Info, H323Connection, OnUserInputInlineRFC2833);
    PDECLARE_NOTIFIER(H323Codec::FilterInfo, H323Connection, OnUserInputInBandDTMF);

    H323EndPoint & endpoint;
    PSyncPoint     * endSync;

    int                  remoteCallWaiting; // Number of call's waiting at the remote endpoint
    BOOL                 callAnswered;
    BOOL                 gatekeeperRouted;
    unsigned             distinctiveRing;
    PString              callToken;
    unsigned             callReference;
    OpalGloballyUniqueID callIdentifier;
    OpalGloballyUniqueID conferenceIdentifier;

    PStringList        localAliasNames;
    PString            localPartyName;
    PString            localDisplayName;
    H323Capabilities   localCapabilities; // Capabilities local system supports
    PString            remotePartyName;
    PString            remotePartyNumber;
    PString            remotePartyAddress;
        PStringArray       remoteAliasNames;
    PString            destExtraCallInfo;
    PString            remoteApplication;
    H323Capabilities   remoteCapabilities; // Capabilities remote system supports
    unsigned           remoteMaxAudioDelayJitter;
    PTimer             roundTripDelayTimer;
    unsigned           minAudioJitterDelay;
    unsigned           maxAudioJitterDelay;
    unsigned           bandwidthAvailable;
    unsigned           uuiesRequested;
    PString            gkAccessTokenOID;
    PBYTEArray         gkAccessTokenData;
    BOOL               addAccessTokenToSetup;
    SendUserInputModes sendUserInputMode;

    H323Transport * signallingChannel;
    H323Transport * controlChannel;
    BOOL            h245Tunneling;
    H323SignalPDU * h245TunnelRxPDU;
    H323SignalPDU * h245TunnelTxPDU;
    H323SignalPDU * alertingPDU;
    H323SignalPDU * connectPDU;

    enum ConnectionStates {
      NoConnectionActive,
      AwaitingGatekeeperAdmission,
      AwaitingTransportConnect,
      AwaitingSignalConnect,
      AwaitingLocalAnswer,
      HasExecutedSignalConnect,
      EstablishedConnection,
      ShuttingDownConnection,
      NumConnectionStates
    } connectionState;

    PTime         setupTime;
    PTime         alertingTime;
    PTime         connectedTime;
    PTime         callEndTime;
    PTime         reverseMediaOpenTime;
    CallEndReason callEndReason;
    unsigned      q931Cause;
    ReleaseSequence releaseSequence;

    unsigned   h225version;
    unsigned   h245version;
    BOOL       h245versionSet;
    BOOL doH245inSETUP;
    BOOL lastPDUWasH245inSETUP;
    BOOL detectInBandDTMF;
    BOOL mustSendDRQ;
    BOOL mediaWaitForConnect;
    BOOL transmitterSidePaused;
    BOOL earlyStart;

#ifdef H323_T120
    BOOL startT120;
#endif

#ifdef H323_T38
    PString    t38ModeChangeCapabilities;
#endif

#ifdef H323_H224
        BOOL startH224;
#endif

    PSyncPoint digitsWaitFlag;
    BOOL       endSessionNeeded;
    BOOL       endSessionSent;
    PSyncPoint endSessionReceived;
    PTimer     enforcedDurationLimit;

#ifdef H323_H450
    // Used as part of a local call hold operation involving MOH
    PChannel * holdAudioMediaChannel;
    PChannel * holdVideoMediaChannel;
    BOOL       isConsultationTransfer;

    BOOL     isCallIntrusion;
    unsigned callIntrusionProtectionLevel;
#endif

    RTP_SessionManager rtpSessions;

    enum FastStartStates {
      FastStartDisabled,
      FastStartInitiate,
      FastStartResponse,
      FastStartAcknowledged,
      NumFastStartStates
    };
    FastStartStates        fastStartState;
    H323LogicalChannelList fastStartChannels;

#if PTRACING
    static const char * const ConnectionStatesNames[NumConnectionStates];
    friend ostream & operator<<(ostream & o, ConnectionStates s) { return o << ConnectionStatesNames[s]; }
    static const char * const FastStartStateNames[NumFastStartStates];
    friend ostream & operator<<(ostream & o, FastStartStates s) { return o << FastStartStateNames[s]; }
#endif


    // The following pointers are to protocol procedures, they are pointers to
    // hide their complexity from the H323Connection classes users.
    H245NegMasterSlaveDetermination  * masterSlaveDeterminationProcedure;
    H245NegTerminalCapabilitySet     * capabilityExchangeProcedure;
    H245NegLogicalChannels           * logicalChannels;
    H245NegRequestMode               * requestModeProcedure;
    H245NegRoundTripDelay            * roundTripDelayProcedure;

#ifdef H323_H450
    H450xDispatcher                  * h450dispatcher;
    H4502Handler                     * h4502handler;
    H4503Handler                     * h4503handler;
    H4504Handler                     * h4504handler;
    H4506Handler                     * h4506handler;
    H45011Handler                    * h45011handler;
#endif

    OpalRFC2833                      * rfc2833handler;

#ifdef H323_T120
    OpalT120Protocol                 * t120handler;
#endif

#ifdef H323_T38
    OpalT38Protocol                  * t38handler;
#endif

#ifdef H323_H224
    OpalH224Handler                  * h224handler;
    OpalH281Handler                  * h281handler;
#endif

#ifdef P_DTMF
    // The In-Band DTMF detector. This is used inside an audio filter which is
    // added to the audio channel.
    PDTMFDecoder                     dtmfDecoder;
#endif

    // used to detect remote NAT endpoints
    BOOL remoteIsNAT;    
        BOOL NATsupport;     
        BOOL sameNAT;        

#ifndef DISABLE_CALLAUTH
    BOOL AuthenticationFailed;
    BOOL hasAuthentication;
    const H235Authenticators  EPAuthenticators;
#endif

#ifdef H323_AEC
        PAec * aec;
#endif

    BOOL IsNonCallConnection; 

  private:
    PChannel * SwapHoldMediaChannels(PChannel * newChannel,unsigned sessionId);

    PTimedMutex outerMutex;
    PMutex innerMutex;

  public:
    BOOL StartHandleControlChannel();
    void EndHandleControlChannel();

#ifdef H323_RTP_AGGREGATE
  private:
    BOOL useRTPAggregation;
#endif

#ifdef H323_SIGNAL_AGGREGATE
  public:
    void AggregateSignalChannel(H323Transport * transport);
    void AggregateControlChannel(H323Transport * transport);
  protected:
    BOOL useSignallingAggregation;
    H323AggregatedH2x5Handle * signalAggregator;
    H323AggregatedH2x5Handle * controlAggregator;
#endif

#ifdef H323_H248
    PDictionary<POrdinalKey, H323ServiceControlSession> serviceControlSessions;
#endif

#ifdef H323_H460
        BOOL disableH460;
        H460_FeatureSet & features;
#endif

#ifdef H323_H224
  OpalH224Handler                 * h224Handler;
#endif
};


PLIST(H323ConnectionList, H323Connection);
PDICTIONARY(H323ConnectionDict, PString, H323Connection);
PDICTIONARY(H323CallIdentityDict, PString, H323Connection);


#endif // __OPAL_H323CON_H

---