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

/*
 * h323ep.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: h323ep.h,v $
 * Revision 1.2  2007/08/20 19:13:27  shorne
 * Added Generic Capability support. Fixed Linux compile errors
 *
 * Revision 1.1  2007/08/06 20:50:49  shorne
 * First commit of h323plus
 *
 * Revision 1.87.2.8  2007/07/20 22:03:21  shorne
 * Initial H.350 Support
 *
 * Revision 1.87.2.7  2007/05/23 06:59:36  shorne
 * Added Assigned Alias/Gatekeeper
 *
 * Revision 1.87.2.6  2007/04/19 12:16:15  shorne
 * added ability to detect if no nat
 *
 * Revision 1.87.2.5  2007/02/19 20:11:05  shorne
 * Added Baseline H.239 Support
 *
 * Revision 1.87.2.4  2007/02/11 00:45:20  shorne
 * Added ability to disable NAT method on a call by call basis
 *
 * Revision 1.87.2.3  2007/02/02 22:12:43  shorne
 * Added ability to set FrameSize for video plugins
 *
 * Revision 1.87.2.2  2007/01/30 01:07:40  shorne
 * Added ability to disable H460
 *
 * Revision 1.87.2.1  2006/12/23 19:08:02  shorne
 * Plugin video codecs & sundry
 *
 * Revision 1.87  2006/06/26 02:52:51  shorne
 * Moved H460 feature loader from H323EndPoint Constructor
 *
 * Revision 1.86  2006/06/23 20:01:28  shorne
 * More H460 support
 *
 * Revision 1.85  2006/06/23 07:06:04  csoutheren
 * Fixed linux compile
 *
 * Revision 1.84  2006/06/23 06:02:44  csoutheren
 * Added missing declarations for H.224 backport
 *
 * Revision 1.83  2006/06/09 06:30:12  csoutheren
 * Remove compile warning and errors with gcc
 *
 * Revision 1.82  2006/05/30 11:14:55  hfriederich
 * Switch from DISABLE_H460 to H323_H460
 *
 * Revision 1.81  2006/05/16 11:44:09  shorne
 * extended DNS SRV, H460 Feature , Call Credit, extend conference goals
 *
 * Revision 1.80  2006/03/07 10:37:46  csoutheren
 * Add ability to disable GRQ on GK registration
 *
 * Revision 1.79  2006/01/26 03:47:17  shorne
 * Caller Authentication, more Nat Traversal support, more PBX support
 *
 * Revision 1.78  2006/01/20 00:32:24  csoutheren
 * First check-in of signalling aggregation code - incomplete and disabled by default
 *
 * Revision 1.77  2006/01/18 07:46:08  csoutheren
 * Initial version of RTP aggregation (disabled by default)
 *
 * Revision 1.76  2005/11/30 13:05:01  csoutheren
 * Changed tags for Doxygen
 *
 * Revision 1.75  2005/11/22 03:38:45  shorne
 * Added ToS support to TCP Transports. thx Norbert Bartalsky (TOPCALL)
 *
 * Revision 1.74  2005/11/21 21:02:19  shorne
 * Added GnuGK Nat detection support
 *
 * Revision 1.73  2005/09/16 08:12:49  csoutheren
 * Added ability to set timeout for connect
 *
 * Revision 1.72  2005/07/12 12:28:52  csoutheren
 * Fixes for H.450 errors and return values
 * Thanks to Iker Perez San Roman
 *
 * Revision 1.71  2005/03/10 07:01:29  csoutheren
 * Fixed problem with H.450 call identifiers not being unique across all calls on an
 *  endpoint. Thanks to Thien Nguyen
 *
 * Revision 1.70  2005/01/03 14:03:20  csoutheren
 * Added new configure options and ability to disable/enable modules
 *
 * Revision 1.69  2005/01/03 06:25:52  csoutheren
 * Added extensive support for disabling code modules at compile time
 *
 * Revision 1.68  2004/12/20 02:32:34  csoutheren
 * Cleeaned up OSP functions
 *
 * Revision 1.67  2004/12/08 01:59:22  csoutheren
 * initial support for Transnexus OSP toolkit
 *
 * Revision 1.66  2004/11/25 07:38:58  csoutheren
 * Ensured that external TCP address translation is performed when using STUN to handle UDP
 *
 * Revision 1.65  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.64  2004/07/27 05:28:45  csoutheren
 * Added ability to set priority of channel threads
 *
 * Revision 1.63  2004/07/27 01:15:16  csoutheren
 * Added virtual to InternalMakeCall
 *
 * Revision 1.62  2004/07/19 13:19:55  csoutheren
 * Fixed typo in secondaryConnectionsActive
 *
 * Revision 1.61  2004/07/11 11:36:25  rjongbloed
 * Added virtual to CleanUpConnections, thanks Eize Slange
 *
 * Revision 1.60  2004/06/15 03:30:00  csoutheren
 * Added OnSendARQ to allow access to the ARQ message before sent by connection
 *
 * Revision 1.59  2004/06/04 07:05:10  csoutheren
 * Fixed obvious typos
 *
 * Revision 1.58  2004/06/01 05:48:02  csoutheren
 * Changed capability table to use abstract factory routines rather than internal linked list
 *
 * Revision 1.57  2004/05/17 12:14:24  csoutheren
 * Added support for different SETUP PDU types
 *
 * Revision 1.56  2003/12/29 04:58:55  csoutheren
 * Added callbacks on H323EndPoint when gatekeeper discovery succeeds or fails
 *
 * Revision 1.55  2003/12/28 02:52:15  csoutheren
 * Added virtual to a few functions
 *
 * Revision 1.54  2003/12/28 02:38:14  csoutheren
 * Added H323EndPoint::OnOutgoingCall
 *
 * Revision 1.53  2003/12/28 00:07:10  csoutheren
 * Added callbacks on H323EndPoint when gatekeeper registration succeeds or fails
 *
 * Revision 1.52  2003/04/24 01:49:33  dereks
 * Add ability to set no media timeout interval
 *
 * Revision 1.51  2003/04/10 09:39:48  robertj
 * Added associated transport to new GetInterfaceAddresses() function so
 *   interfaces can be ordered according to active transport links. Improves
 *   interoperability.
 *
 * Revision 1.50  2003/04/10 01:05:11  craigs
 * Added functions to access to lists of interfaces
 *
 * Revision 1.49  2003/04/07 13:09:25  robertj
 * Added ILS support to callto URL parsing in MakeCall(), ie can now call hosts
 *   registered with an ILS directory.
 *
 * Revision 1.48  2003/02/13 00:11:31  robertj
 * Added missing virtual for controlling call transfer, thanks Andrey Pinaev
 *
 * Revision 1.47  2003/02/09 00:48:06  robertj
 * Added function to return if registered with gatekeeper.
 *
 * Revision 1.46  2003/02/04 07:06:41  robertj
 * Added STUN support.
 *
 * Revision 1.45  2003/01/26 05:57:58  robertj
 * Changed ParsePartyName so will accept addresses of the form
 *   alias@gk:address which will do an LRQ call to "address" using "alias"
 *   to determine the IP address to connect to.
 *
 * Revision 1.44  2003/01/23 02:36:30  robertj
 * Increased (and made configurable) timeout for H.245 channel TCP connection.
 *
 * Revision 1.43  2002/11/28 01:19:55  craigs
 * Added virtual to several functions
 *
 * Revision 1.42  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.41  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.40  2002/11/10 08:10:43  robertj
 * Moved constants for "well known" ports to better place (OPAL change).
 *
 * Revision 1.39  2002/10/31 00:32:15  robertj
 * Enhanced jitter buffer system so operates dynamically between minimum and
 *   maximum values. Altered API to assure app writers note the change!
 *
 * Revision 1.38  2002/10/23 06:06:10  robertj
 * Added function to be smarter in using a gatekeeper for use by endpoint.
 *
 * Revision 1.37  2002/10/21 06:07:44  robertj
 * Added function to set gatekeeper access token OID.
 *
 * Revision 1.36  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.35  2002/09/10 06:32:25  robertj
 * Added function to get gatekeeper password.
 *
 * Revision 1.34  2002/09/03 06:19:36  robertj
 * Normalised the multi-include header prevention ifdef/define symbol.
 *
 * Revision 1.33  2002/07/19 03:39:19  robertj
 * Bullet proofed setting of RTP IP port base, can't be zero!
 *
 * Revision 1.32  2002/07/18 01:50:10  robertj
 * Changed port secltion code to force apps to use function interface.
 *
 * Revision 1.31  2002/06/22 05:48:38  robertj
 * Added partial implementation for H.450.11 Call Intrusion
 *
 * Revision 1.30  2002/06/13 06:15:19  robertj
 * Allowed TransferCall() to be used on H323Connection as well as H323EndPoint.
 *
 * Revision 1.29  2002/06/12 03:55:21  robertj
 * Added function to add/remove multiple listeners in one go comparing against
 *   what is already running so does not interrupt unchanged listeners.
 *
 * Revision 1.28  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.27  2002/05/28 06:15:09  robertj
 * Split UDP (for RAS) from RTP port bases.
 * Added current port variable so cycles around the port range specified which
 *   fixes some wierd problems on some platforms, thanks Federico Pinna
 *
 * Revision 1.26  2002/05/17 03:38:05  robertj
 * Fixed problems with H.235 authentication on RAS for server and client.
 *
 * Revision 1.25  2002/05/16 00:03:05  robertj
 * Added function to get the tokens for all active calls.
 * Improved documentation for use of T.38 and T.120 functions.
 *
 * Revision 1.24  2002/05/15 08:59:18  rogerh
 * Update comments
 *
 * Revision 1.23  2002/05/03 05:38:15  robertj
 * Added Q.931 Keypad IE mechanism for user indications (DTMF).
 *
 * Revision 1.22  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.21  2002/04/18 01:41:07  robertj
 * Fixed bad variable name for disabling DTMF detection, very confusing.
 *
 * Revision 1.20  2002/04/17 00:49:56  robertj
 * Added ability to disable the in band DTMF detection.
 *
 * Revision 1.19  2002/04/10 06:48:47  robertj
 * Added functions to set port member variables.
 *
 * Revision 1.18  2002/03/14 03:49:38  dereks
 * Fix minor documentation error.
 *
 * Revision 1.17  2002/02/04 07:17:52  robertj
 * Added H.450.2 Consultation Transfer, thanks Norwood Systems.
 *
 * Revision 1.16  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.15  2002/01/17 07:04:58  robertj
 * Added support for RFC2833 embedded DTMF in the RTP stream.
 *
 * Revision 1.14  2002/01/13 23:59:43  robertj
 * Added CallTransfer timeouts to endpoint, hanks Ben Madsen of Norwood Systems.
 *
 * Revision 1.13  2002/01/08 04:45:35  robertj
 * Added MakeCallLocked() so can start a call with the H323Connection instance
 *   initally locked so can do things to it before the call really starts.
 *
 * Revision 1.12  2001/12/22 03:20:44  robertj
 * Added create protocol function to H323Connection.
 *
 * Revision 1.11  2001/12/13 10:55:30  robertj
 * Added gatekeeper access token OID specification for auto inclusion of
 *   access tokens frm ACF to SETUP pdu.
 *
 * Revision 1.10  2001/11/09 05:39:54  craigs
 * Added initial T.38 support thanks to Adam Lazur
 *
 * Revision 1.9  2001/11/01 00:27:33  robertj
 * Added default Fast Start disabled and H.245 tunneling disable flags
 *   to the endpoint instance.
 *
 * Revision 1.8  2001/09/11 01:24:36  robertj
 * Added conditional compilation to remove video and/or audio codecs.
 *
 * Revision 1.7  2001/09/11 00:21:21  robertj
 * Fixed missing stack sizes in endpoint for cleaner thread and jitter thread.
 *
 * Revision 1.6  2001/08/24 14:03:26  rogerh
 * Fix some spelling mistakes
 *
 * Revision 1.5  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.4  2001/08/10 11:03:49  robertj
 * Major changes to H.235 support in RAS to support server.
 *
 * Revision 1.3  2001/08/08 23:54:11  robertj
 * Fixed problem with setting gk password before have a gk variable.
 *
 * Revision 1.2  2001/08/06 03:15:17  robertj
 * Improved access to H.235 secure RAS functionality.
 *
 * 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_H323EP_H
#define __OPAL_H323EP_H

#include "h323.h"
#include "h323con.h"

class PHandleAggregator;

/* 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 H225_EndpointType;
class H225_ArrayOf_SupportedProtocols;
class H225_VendorIdentifier;
class H225_H221NonStandard;
class H225_ServiceControlDescriptor;
class H225_ArrayOf_AliasAddress;

class H323SignalPDU;
class H323ConnectionsCleaner;
class H323ServiceControlSession;

#if H323_H224
class OpalH224Handler;
class OpalH281Handler;
#endif

#ifndef DISABLE_CALLAUTH
#include "h235auth.h"
#endif

#ifdef H323_T120
class OpalT120Protocol;
#endif

#ifdef H323_T38
class OpalT38Protocol;
#endif

#ifdef H323_H224
class OpalH224Handler;
class OpalH281Handler;
#endif

#ifdef P_STUN
#include <ptclib/pnat.h>
class PSTUNClient;
#endif

#ifdef P_USE_PRAGMA
#pragma interface
#endif

#ifdef H323_H460
#include "h460/h4601.h"
#endif


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

  public:
    enum {
      DefaultTcpPort = 1720
    };

    H323EndPoint();

    ~H323EndPoint();

    virtual void SetEndpointTypeInfo(
      H225_EndpointType & info
    ) const;

    virtual void SetVendorIdentifierInfo(
      H225_VendorIdentifier & info
    ) const;

    BOOL SetGatewaySupportedProtocol(
                H225_ArrayOf_SupportedProtocols & protocols
        ) const;

    virtual BOOL OnSetGatewayPrefixes(
                PStringList & prefixes
        ) const;

    virtual void SetH221NonStandardInfo(
      H225_H221NonStandard & info
    ) const;


    void AddCapability(
      H323Capability * capability   
    );

    PINDEX SetCapability(
      PINDEX descriptorNum, 
      PINDEX simultaneous,  
      H323Capability * cap  
    );

#ifdef H323_VIDEO

        BOOL SetVideoFrameSize(H323Capability::CapabilityFrameSize frameSize, 
                                  int frameUnits = 1
        );
#endif

    PINDEX AddAllCapabilities(
      PINDEX descriptorNum, 
      PINDEX simultaneous,  
      const PString & name  
    );

    void AddAllUserInputCapabilities(
      PINDEX descriptorNum, 
      PINDEX simultaneous   
    );

#ifdef H323_H239

    void AddAllExtendedVideoCapabilities(
      PINDEX descriptorNum, 
      PINDEX simultaneous   
    );
#endif

    void RemoveCapabilities(
      const PStringArray & codecNames
    );

    void ReorderCapabilities(
      const PStringArray & preferenceOrder
    );

    H323Capability * FindCapability(
      const H245_Capability & cap  
    ) const;

    H323Capability * FindCapability(
      const H245_DataType & dataType  
    ) const;

    H323Capability * FindCapability(
      H323Capability::MainTypes mainType,   
      unsigned subType                      
    ) const;

    BOOL UseGatekeeper(
      const PString & address = PString::Empty(),     
      const PString & identifier = PString::Empty(),  
      const PString & localAddress = PString::Empty() 
    );

    BOOL SetGatekeeper(
      const PString & address,          
      H323Transport * transport = NULL  
    );

    BOOL SetGatekeeperZone(
      const PString & address,          
      const PString & identifier,       
      H323Transport * transport = NULL  
    );

    BOOL LocateGatekeeper(
      const PString & identifier,       
      H323Transport * transport = NULL  
    );

    BOOL DiscoverGatekeeper(
      H323Transport * transport = NULL  
    );

    virtual H323Gatekeeper * CreateGatekeeper(
      H323Transport * transport  
    );

    H323Gatekeeper * GetGatekeeper() const { return gatekeeper; }

    BOOL IsRegisteredWithGatekeeper() const;

    BOOL RemoveGatekeeper(
      int reason = -1    
    );

    virtual void SetGatekeeperPassword(
      const PString & password
    );

    virtual const PString & GetGatekeeperPassword() const { return gatekeeperPassword; }

        virtual BOOL GatekeeperCheckIP(const H323TransportAddress & oldAddr,H323TransportAddress & newaddress);

    virtual H235Authenticators CreateAuthenticators();

        virtual void OnAdmissionRequest(H323Connection & connection);

    virtual void  OnGatekeeperConfirm();

    virtual void  OnGatekeeperReject();

    virtual void OnRegistrationConfirm(const H323TransportAddress & rasAddress);

    virtual void  OnRegistrationReject();

        virtual void OnUnRegisterRequest(); 

    BOOL StartListener(
      H323Listener * listener 
    );

    BOOL StartListener(
      const H323TransportAddress & iface 
    );

    BOOL StartListeners(
      const H323TransportAddressArray & ifaces 
    );

    BOOL RemoveListener(
      H323Listener * listener 
    );

    H323TransportAddressArray GetInterfaceAddresses(
      BOOL excludeLocalHost = TRUE,       
      H323Transport * associatedTransport = NULL
    );

#ifndef DISABLE_CALLAUTH

      H323Connection * MakeAuthenticatedCall (
                        const PString & remoteParty,  
                        const PString & UserName,     
                        const PString & Password,     
                        PString & token,              
                        void * userData = NULL        
     );                                                                                 
#endif                                                          

    H323Connection * MakeCall(
      const PString & remoteParty,  
      PString & token,              
      void * userData = NULL        
    );

    H323Connection * MakeCall(
      const PString & remoteParty,  
      H323Transport * transport,    
      PString & token,              
      void * userData = NULL        
    );

    H323Connection * MakeCallLocked(
      const PString & remoteParty,     
      PString & token,                 
      void * userData = NULL,          
      H323Transport * transport = NULL 
    );

#ifdef H323_H450

    virtual H323Connection * SetupTransfer(
      const PString & token,        
      const PString & callIdentity, 
      const PString & remoteParty,  
      PString & newToken,           
      void * userData = NULL        
    );

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

    void ConsultationTransfer(
      const PString & primaryCallToken,   
      const PString & secondaryCallToken  
    );

    void HoldCall(
      const PString & token,        
      BOOL localHold   
    );

    H323Connection * IntrudeCall(
      const PString & remoteParty,  
      PString & token,              
      unsigned capabilityLevel,     
      void * userData = NULL        
    );

    H323Connection * IntrudeCall(
      const PString & remoteParty,  
      H323Transport * transport,    
      PString & token,              
      unsigned capabilityLevel,     
      void * userData = NULL        
    );

#endif // H323_H450

    BOOL ResolveCallParty(
      const PString & _remoteParty, 
      PStringList & addresses
    );

    BOOL ParsePartyName(
      const PString & party,          
      PString & alias,                
      H323TransportAddress & address  
    );

    virtual BOOL ClearCall(
      const PString & token,  
      H323Connection::CallEndReason reason =
                  H323Connection::EndedByLocalUser 
    );

     virtual void OnCallClearing(H323Connection * connection,       
                              H323Connection::CallEndReason reason  
     );

    virtual BOOL ClearCallSynchronous(
      const PString & token,            
      H323Connection::CallEndReason reason =
                        H323Connection::EndedByLocalUser 
    );
    virtual BOOL ClearCallSynchronous(
      const PString & token,                
      H323Connection::CallEndReason reason, 
      PSyncPoint * sync
    );

    virtual void ClearAllCalls(
      H323Connection::CallEndReason reason =
                  H323Connection::EndedByLocalUser, 
      BOOL wait = TRUE   
    );

    virtual BOOL HasConnection(
      const PString & token   
    );

    H323Connection * FindConnectionWithLock(
      const PString & token     
    );

    PStringList GetAllConnections();

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

    virtual BOOL OnCallTransferInitiate(
      H323Connection & connection,    
      const PString & remoteParty     
    );

    virtual BOOL OnCallTransferIdentify(
      H323Connection & connection    
    );

    virtual void OnSendARQ(
      H323Connection & conn,
      H225_AdmissionRequest & arq
    );

    virtual void OnReceivedACF(
      H323Connection & conn,
      const H225_AdmissionConfirm & acf
    );

    virtual void OnReceivedARJ(
      H323Connection & conn,
      const H225_AdmissionReject & arj
    );

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

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

    virtual BOOL OnConnectionForwarded(
      H323Connection & connection,    
      const PString & forwardParty,   
      const H323SignalPDU & pdu       
    );

    virtual BOOL ForwardConnection(
      H323Connection & connection,    
      const PString & forwardParty,   
      const H323SignalPDU & pdu       
    );

    virtual void OnConnectionEstablished(
      H323Connection & connection,    
      const PString & token           
    );

    virtual BOOL IsConnectionEstablished(
      const PString & token   
    );

    virtual void OnConnectionCleared(
      H323Connection & connection,    
      const PString & token           
    );

    static PString BuildConnectionToken(
      const H323Transport & transport,  
      unsigned callReference,           
      BOOL fromRemote                   
    );

    virtual H323Connection * OnIncomingConnection(
      H323Transport * transport,  
      H323SignalPDU & setupPDU    
    );

    virtual BOOL OnOutgoingCall(
        H323Connection & conn, 
        const H323SignalPDU & connectPDU
    );

    virtual H323Connection * CreateConnection(
      unsigned callReference,     
      void * userData,            
      H323Transport * transport,  
      H323SignalPDU * setupPDU    
    );
    virtual H323Connection * CreateConnection(
      unsigned callReference,   
      void * userData           
    );
    virtual H323Connection * CreateConnection(
      unsigned callReference    
    );

    virtual void CleanUpConnections();

#ifndef DISABLE_CALLAUTH

     virtual H235Authenticators CreateEPAuthenticators();

    virtual BOOL GetEPCredentials(PString & password,   
                                  PString & username    
                                  );

     virtual void SetEPCredentials(PString password,   
                                   PString username    
                                   );

     enum EPSecurityPolicy
     {
         SecNone,           
         SecRequest,        
         SecRequired        
     };

     virtual void SetEPSecurityPolicy(EPSecurityPolicy policy);

     virtual EPSecurityPolicy GetEPSecurityPolicy();

     H235AuthenticatorList GetAuthenticatorList();

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

    virtual BOOL OnStartLogicalChannel(
      H323Connection & connection,    
      H323Channel & channel           
    );

    virtual void OnClosedLogicalChannel(
      H323Connection & connection,    
      const H323Channel & channel     
    );

#ifndef NO_H323_AUDIO_CODECS

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

#ifndef NO_H323_VIDEO

    virtual BOOL OpenVideoChannel(
      H323Connection & connection,  
      BOOL isEncoding,              
      H323VideoCodec & codec        
    );
#endif // NO_H323_VIDEO

    virtual void OnRTPStatistics(
      const H323Connection & connection,  
      const RTP_Session & session         
    ) const;

    virtual void OnRTPFinalStatistics(
      const H323Connection & connection,  
      const RTP_Session & session         
    ) const;


    virtual void OnUserInputString(
      H323Connection & connection,  
      const PString & value         
    );

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

        virtual void OnGatekeeperNATDetect(
                PIPSocket::Address publicAddr,         
                PString & gkIdentifier,                
                H323TransportAddress & gkRouteAddress  
                );
                
        virtual void OnGatekeeperOpenNATDetect(
                PString & gkIdentifier,                
                H323TransportAddress & gkRouteAddress  
                );

        virtual BOOL OnGatekeeperAliases(
                const H225_ArrayOf_AliasAddress & aliases  
                );

#ifdef H323_H248

    virtual void OnHTTPServiceControl(
      unsigned operation,  
      unsigned sessionId,  
      const PString & url  
    );

        virtual void OnCallCreditServiceControl(
      const PString & amount,         
      BOOL mode,                      
          const unsigned & durationLimit  
    );

#ifdef H323_H350

    virtual void OnH350ServiceControl(
                const PString & url,
                const PString & BaseDN
                );
#endif

    virtual void OnCallCreditServiceControl(
      const PString & amount,  
      BOOL mode          
    );

    virtual void OnServiceControlSession(
      unsigned type,
      unsigned sessionid,
      const H323ServiceControlSession & session,
      H323Connection * connection
    );

    virtual H323ServiceControlSession * CreateServiceControlSession(
      const H225_ServiceControlDescriptor & contents
    );
#endif // H323_H248

#ifdef H323_T120

    virtual OpalT120Protocol * CreateT120ProtocolHandler(
      const H323Connection & connection  
    ) const;
#endif

#ifdef H323_T38

    virtual OpalT38Protocol * CreateT38ProtocolHandler(
      const H323Connection & connection  
    ) const;
#endif

#if H323_H224

    virtual OpalH224Handler * CreateH224ProtocolHandler(
      H323Connection & connection, 
      unsigned sessionID
    ) const;
        
    virtual OpalH281Handler * CreateH281ProtocolHandler(
      OpalH224Handler & h224Handler
    ) const;
#endif

    virtual BOOL OnConferenceInvite(
      BOOL sending,                       
      const H323Connection * connection,  
      const H323SignalPDU & setupPDU      
    );

    virtual BOOL OnSendCallIndependentSupplementaryService(
      const H323Connection * connection,  
      H323SignalPDU & pdu                 
    );

    virtual BOOL OnReceiveCallIndependentSupplementaryService(
      const H323Connection * connection,  
      const H323SignalPDU & pdu                 
    );

    virtual BOOL OnNegotiateConferenceCapabilities(
      const H323SignalPDU & setupPDU
    );

    virtual void SetLocalUserName(
      const PString & name  
    );

    virtual const PString & GetLocalUserName() const { return localAliasNames[0]; }

    BOOL AddAliasName(
      const PString & name  
    );

    BOOL RemoveAliasName(
      const PString & name  
    );

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

#if P_LDAP

    const PString & GetDefaultILSServer() const { return ilsServer; }

    void SetDefaultILSServer(
      const PString & server
      ) { ilsServer = server; }

#endif

    BOOL IsFastStartDisabled() const
      { return disableFastStart; }

    void DisableFastStart(
      BOOL mode 
    ) { disableFastStart = mode; } 

    BOOL IsH245TunnelingDisabled() const
      { return disableH245Tunneling; }

    void DisableH245Tunneling(
      BOOL mode 
    ) { disableH245Tunneling = mode; } 

    BOOL IsH245inSetupDisabled() const
      { return disableH245inSetup; }

    void DisableH245inSetup(
      BOOL mode 
    ) { disableH245inSetup = mode; } 

    BOOL DetectInBandDTMFDisabled() const
      { return disableDetectInBandDTMF; }

    void DisableDetectInBandDTMF(
      BOOL mode 
    ) { disableDetectInBandDTMF = mode; } 

    BOOL CanDisplayAmountString() const
      { return canDisplayAmountString; }

    void SetCanDisplayAmountString(
      BOOL mode 
    ) { canDisplayAmountString = mode; } 

    BOOL CanEnforceDurationLimit() const
      { return canEnforceDurationLimit; }

    void SetCanEnforceDurationLimit(
      BOOL mode 
    ) { canEnforceDurationLimit = mode; } 

#ifdef H323_RTP_AGGREGATE

    void SetRTPAggregatationSize(
      PINDEX size            
    ) { rtpAggregationSize = size; }

    PINDEX GetRTPAggregationSize() const
    { return rtpAggregationSize; }

    PHandleAggregator * GetRTPAggregator();
#endif

#ifdef H323_SIGNAL_AGGREGATE

    void SetSignallingAggregationSize(
      PINDEX size            
    ) { signallingAggregationSize = size; }

    PINDEX GetSignallingAggregationSize() const
    { return signallingAggregationSize; }

    PHandleAggregator * GetSignallingAggregator();
#endif

#ifdef H323_H450

    unsigned GetCallIntrusionProtectionLevel() const { return callIntrusionProtectionLevel; }

    void SetCallIntrusionProtectionLevel(
      unsigned level  
    ) { PAssert(level<=3, PInvalidParameter); callIntrusionProtectionLevel = level; }

    virtual void OnReceivedInitiateReturnError();

#endif // H323_H450

#ifdef H323_AUDIO_CODECS
#ifdef P_AUDIO

    virtual BOOL SetSoundChannelPlayDevice(const PString & name);
    virtual BOOL SetSoundChannelPlayDriver(const PString & name);

    const PString & GetSoundChannelPlayDevice() const { return soundChannelPlayDevice; }
    const PString & GetSoundChannelPlayDriver() const { return soundChannelPlayDriver; }

    virtual BOOL SetSoundChannelRecordDevice(const PString & name);
    virtual BOOL SetSoundChannelRecordDriver(const PString & name);

    const PString & GetSoundChannelRecordDevice() const { return soundChannelRecordDevice; }
    const PString & GetSoundChannelRecordDriver() const { return soundChannelRecordDriver; }

    unsigned GetSoundChannelBufferDepth() const { return soundChannelBuffers; }

    void SetSoundChannelBufferDepth(
      unsigned depth    
    );

#endif  // P_AUDIO

    H323AudioCodec::SilenceDetectionMode GetSilenceDetectionMode() const
      { return defaultSilenceDetection; }

    void SetSilenceDetectionMode(
      H323AudioCodec::SilenceDetectionMode mode 
    ) { defaultSilenceDetection = mode; } 

#endif  // H323_AUDIO_CODECS

    H323Connection::SendUserInputModes GetSendUserInputMode() const { return defaultSendUserInputMode; }

    void SetSendUserInputMode(H323Connection::SendUserInputModes mode) { defaultSendUserInputMode = mode; }

#ifdef H323_VIDEO

    BOOL CanAutoStartReceiveVideo() const { return autoStartReceiveVideo; }

    BOOL CanAutoStartTransmitVideo() const { return autoStartTransmitVideo; }

#endif  // H323_VIDEO

#ifdef H323_T38

    BOOL CanAutoStartReceiveFax() const { return autoStartReceiveFax; }

    BOOL CanAutoStartTransmitFax() const { return autoStartTransmitFax; }

#endif // H323_T38

    BOOL CanAutoCallForward() const { return autoCallForward; }

    const H323ListenerList & GetListeners() const { return listeners; }

    const H323Capabilities & GetCapabilities() const { return capabilities; }

    enum TerminalTypes {
      e_TerminalOnly = 50,
      e_TerminalAndMC = 70,
      e_GatewayOnly = 60,
      e_GatewayAndMC = 80,
      e_GatewayAndMCWithDataMP = 90,
      e_GatewayAndMCWithAudioMP = 100,
      e_GatewayAndMCWithAVMP = 110,
      e_GatekeeperOnly = 120,
      e_GatekeeperWithDataMP = 130,
      e_GatekeeperWithAudioMP = 140,
      e_GatekeeperWithAVMP = 150,
      e_MCUOnly = 160,
      e_MCUWithDataMP = 170,
      e_MCUWithAudioMP = 180,
      e_MCUWithAVMP = 190
    };

    TerminalTypes GetTerminalType() const { return terminalType; }

    BOOL IsTerminal() const;

    BOOL IsGateway() const;

    BOOL IsGatekeeper() const;

    BOOL IsMCU() const;

#ifdef H323_AUDIO_CODECS

    unsigned GetMinAudioJitterDelay() const { return minAudioJitterDelay; }

    unsigned GetMaxAudioJitterDelay() const { return maxAudioJitterDelay; }

    void SetAudioJitterDelay(
      unsigned minDelay,   
      unsigned maxDelay    
    );
#endif

    unsigned GetInitialBandwidth() const { return initialBandwidth; }

    void SetInitialBandwidth(unsigned bandwidth) { initialBandwidth = bandwidth; }

    virtual BOOL OnSendFeatureSet(unsigned, H225_FeatureSet &);

    virtual void OnReceiveFeatureSet(unsigned, const H225_FeatureSet &);

        virtual void LoadBaseFeatureSet();

        virtual BOOL HandleUnsolicitedInformation(const H323SignalPDU & pdu);

#ifdef H323_H460

    H460_FeatureSet & GetFeatureSet() {  return features.DeriveNewFeatureSet(); };

        BOOL FeatureSetDisabled()  {  return disableH460; }

        void FeatureSetDisable()  {  disableH460 = TRUE;  }

#endif

#ifdef H323_AEC
        BOOL AECEnabled()   {  return enableAEC; }

        void SetAECEnabled(BOOL enabled)  { enableAEC = enabled; }
#endif

#ifdef P_STUN

    PSTUNClient * GetSTUN(
      const PIPSocket::Address & address = 0
    ) const;

    void SetSTUNServer(
      const PString & server
    );

        virtual BOOL STUNNatType(int type) { return FALSE; };

    PNatMethod * GetPreferedNatMethod(
        const PIPSocket::Address & address = 0 
        );

    PNatStrategy GetNatMethods();

#endif // P_NONCORE

    virtual BOOL OnUnsolicitedInformation(const H323SignalPDU & pdu)
    { return FALSE; }

    virtual BOOL IsLocalAddress(
      const PIPSocket::Address & remoteAddress
    ) const;

    virtual void TranslateTCPAddress(
      PIPSocket::Address & /*localAddr*/,
      const PIPSocket::Address & /*remoteAddr */
    ) { }
    void InternalTranslateTCPAddress(
      PIPSocket::Address & /*localAddr*/,
      const PIPSocket::Address & /*remoteAddr */,
          const H323Connection * conn = NULL
    );

    virtual void TranslateTCPPort( 
        WORD & /*ListenPort*/,                     
        const PIPSocket::Address & /*remoteAddr*/  
    ) { };

    WORD GetTCPPortBase() const { return tcpPorts.base; }

    WORD GetTCPPortMax() const { return tcpPorts.max; }

    void SetTCPPorts(unsigned tcpBase, unsigned tcpMax);

    WORD GetNextTCPPort();

    WORD GetUDPPortBase() const { return udpPorts.base; }

    WORD GetUDPPortMax() const { return udpPorts.max; }

    void SetUDPPorts(unsigned udpBase, unsigned udpMax);

    WORD GetNextUDPPort();

    WORD GetRtpIpPortBase() const { return rtpIpPorts.base; }

    WORD GetRtpIpPortMax() const { return rtpIpPorts.max; }

    void SetRtpIpPorts(unsigned udpBase, unsigned udpMax);

    WORD GetRtpIpPortPair();

    BYTE GetRtpIpTypeofService() const { return rtpIpTypeofService; }

    void SetRtpIpTypeofService(unsigned tos) { rtpIpTypeofService = (BYTE)tos; }

    BYTE GetTcpIpTypeofService() const { return tcpIpTypeofService; }

    void SetTcpIpTypeofService(unsigned tos) { tcpIpTypeofService = (BYTE)tos; }

    const PTimeInterval & GetSignallingChannelConnectTimeout() const { return signallingChannelConnectTimeout; }

    const PTimeInterval & GetSignallingChannelCallTimeout() const { return signallingChannelCallTimeout; }

    const PTimeInterval & GetControlChannelStartTimeout() const { return controlChannelStartTimeout; }

    const PTimeInterval & GetEndSessionTimeout() const { return endSessionTimeout; }

    const PTimeInterval & GetMasterSlaveDeterminationTimeout() const { return masterSlaveDeterminationTimeout; }

    unsigned GetMasterSlaveDeterminationRetries() const { return masterSlaveDeterminationRetries; }

    const PTimeInterval & GetCapabilityExchangeTimeout() const { return capabilityExchangeTimeout; }

    const PTimeInterval & GetLogicalChannelTimeout() const { return logicalChannelTimeout; }

    const PTimeInterval & GetRequestModeTimeout() const { return logicalChannelTimeout; }

    const PTimeInterval & GetRoundTripDelayTimeout() const { return roundTripDelayTimeout; }

    const PTimeInterval & GetRoundTripDelayRate() const { return roundTripDelayRate; }

    BOOL ShouldClearCallOnRoundTripFail() const { return clearCallOnRoundTripFail; }

    const PTimeInterval & GetNoMediaTimeout() const;

    BOOL SetNoMediaTimeout(PTimeInterval newInterval);

    const PTimeInterval & GetGatekeeperRequestTimeout() const { return gatekeeperRequestTimeout; }

    unsigned GetGatekeeperRequestRetries() const { return gatekeeperRequestRetries; }

    const PTimeInterval & GetRasRequestTimeout() const { return rasRequestTimeout; }

    unsigned GetRasRequestRetries() const { return rasRequestRetries; }

    const PTimeInterval & GetGatekeeperTimeToLive() const { return registrationTimeToLive; }

    const PString & GetGkAccessTokenOID() const { return gkAccessTokenOID; }

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

    BOOL GetSendGRQ() const
    { return sendGRQ; }

    void SetSendGRQ(BOOL v) 
    { sendGRQ = v; }

#ifdef H323_H450

    const PTimeInterval & GetCallTransferT1() const { return callTransferT1; }

    const PTimeInterval & GetCallTransferT2() const { return callTransferT2; }

    const PTimeInterval & GetCallTransferT3() const { return callTransferT3; }

    const PTimeInterval & GetCallTransferT4() const { return callTransferT4; }

    const PTimeInterval & GetCallIntrusionT1() const { return callIntrusionT1; }
    const PTimeInterval & GetCallIntrusionT2() const { return callIntrusionT2; }
    const PTimeInterval & GetCallIntrusionT3() const { return callIntrusionT3; }
    const PTimeInterval & GetCallIntrusionT4() const { return callIntrusionT4; }
    const PTimeInterval & GetCallIntrusionT5() const { return callIntrusionT5; }
    const PTimeInterval & GetCallIntrusionT6() const { return callIntrusionT6; }

    H323CallIdentityDict& GetCallIdentityDictionary() { return secondaryConnectionsActive; }

    unsigned GetNextH450CallIdentityValue() const { return ++nextH450CallIdentity; }

#endif // H323_H450

    PINDEX GetCleanerThreadStackSize() const { return cleanerThreadStackSize; }

    PINDEX GetListenerThreadStackSize() const { return listenerThreadStackSize; }

    PINDEX GetSignallingThreadStackSize() const { return signallingThreadStackSize; }

    PINDEX GetControlThreadStackSize() const { return controlThreadStackSize; }

    PINDEX GetChannelThreadStackSize() const { return logicalThreadStackSize; }

    PINDEX GetRasThreadStackSize() const { return rasThreadStackSize; }

    PINDEX GetJitterThreadStackSize() const { return jitterThreadStackSize; }

    PThread::Priority GetChannelThreadPriority() const { return channelThreadPriority; }

    H323ConnectionDict GetConnections() { return connectionsActive; };


    static BYTE defaultT35CountryCode;
    static BYTE defaultT35Extension;
    static WORD defaultManufacturerCode;

  protected:
    H323Gatekeeper * InternalCreateGatekeeper(H323Transport * transport);
    BOOL InternalRegisterGatekeeper(H323Gatekeeper * gk, BOOL discovered);
    H323Connection * FindConnectionWithoutLocks(const PString & token);
    virtual H323Connection * InternalMakeCall(
      const PString & existingToken,
      const PString & callIdentity, 
      unsigned capabilityLevel,     
      const PString & remoteParty,  
      H323Transport * transport,    
      PString & token,              
      void * userData               
    );

    // Configuration variables, commonly changed
    PStringList localAliasNames;

#ifdef H323_AUDIO_CODECS
    H323AudioCodec::SilenceDetectionMode defaultSilenceDetection;
    unsigned minAudioJitterDelay;
    unsigned maxAudioJitterDelay;
#ifdef P_AUDIO
    PString     soundChannelPlayDevice;
    PString     soundChannelPlayDriver;
    PString     soundChannelRecordDevice;
    PString     soundChannelRecordDriver;
    unsigned    soundChannelBuffers;
#endif // P_AUDIO
#endif // H323_AUDIO_CODECS

#ifdef H323_VIDEO
    PString     videoChannelPlayDevice;
    PString     videoChannelRecordDevice;
    BOOL        autoStartReceiveVideo;
    BOOL        autoStartTransmitVideo;
#endif // H323_VIDEO

#ifdef H323_T38
    BOOL        autoStartReceiveFax;
    BOOL        autoStartTransmitFax;
#endif // H323_T38

    BOOL        autoCallForward;
    BOOL        disableFastStart;
    BOOL        disableH245Tunneling;
    BOOL        disableH245inSetup;
    BOOL        disableDetectInBandDTMF;
    BOOL        canDisplayAmountString;
    BOOL        canEnforceDurationLimit;

#ifdef H323_H450
    unsigned    callIntrusionProtectionLevel;
#endif // H323_H450

    H323Connection::SendUserInputModes defaultSendUserInputMode;

#ifdef P_LDAP
    PString     ilsServer;
#endif // P_LDAP

    // Some more configuration variables, rarely changed.
    BYTE          rtpIpTypeofService;
    BYTE          tcpIpTypeofService;
    PTimeInterval signallingChannelConnectTimeout;
    PTimeInterval signallingChannelCallTimeout;
    PTimeInterval controlChannelStartTimeout;
    PTimeInterval endSessionTimeout;
    PTimeInterval masterSlaveDeterminationTimeout;
    unsigned      masterSlaveDeterminationRetries;
    PTimeInterval capabilityExchangeTimeout;
    PTimeInterval logicalChannelTimeout;
    PTimeInterval requestModeTimeout;
    PTimeInterval roundTripDelayTimeout;
    PTimeInterval roundTripDelayRate;
    PTimeInterval noMediaTimeout;
    PTimeInterval gatekeeperRequestTimeout;
    unsigned      gatekeeperRequestRetries;
    PTimeInterval rasRequestTimeout;
    unsigned      rasRequestRetries;
    PTimeInterval registrationTimeToLive;
    PString       gkAccessTokenOID;
    BOOL          sendGRQ;

    unsigned initialBandwidth;  // in 100s of bits/sev
    BOOL     clearCallOnRoundTripFail;

    struct PortInfo {
      void Set(
        unsigned base,
        unsigned max,
        unsigned range,
        unsigned dflt
      );
      WORD GetNext(
        unsigned increment
      );

      PMutex mutex;
      WORD   base;
      WORD   max;
      WORD   current;
    } tcpPorts, udpPorts, rtpIpPorts;

#ifdef P_STUN
    PSTUNClient * stun;
        BOOL disableSTUNTranslate;
    PNatStrategy natMethods;
#endif

    BYTE t35CountryCode;
    BYTE t35Extension;
    WORD manufacturerCode;

    TerminalTypes terminalType;

#ifdef H323_H450

    /* Protect against absence of a response to the ctIdentify reqest
       (Transferring Endpoint - Call Transfer with a secondary Call) */
    PTimeInterval callTransferT1;
    /* Protect against failure of completion of the call transfer operation
       involving a secondary Call (Transferred-to Endpoint) */
    PTimeInterval callTransferT2;
    /* Protect against failure of the Transferred Endpoint not responding
       within sufficient time to the ctInitiate APDU (Transferring Endpoint) */
    PTimeInterval callTransferT3;
    /* May optionally operate - protects against absence of a response to the
       ctSetup request (Transferred Endpoint) */
    PTimeInterval callTransferT4;

    PTimeInterval callIntrusionT1;
    PTimeInterval callIntrusionT2;
    PTimeInterval callIntrusionT3;
    PTimeInterval callIntrusionT4;
    PTimeInterval callIntrusionT5;
    PTimeInterval callIntrusionT6;

    H323CallIdentityDict secondaryConnectionsActive;

    mutable PAtomicInteger nextH450CallIdentity; 

#endif // H323_H450

    PINDEX cleanerThreadStackSize;
    PINDEX listenerThreadStackSize;
    PINDEX signallingThreadStackSize;
    PINDEX controlThreadStackSize;
    PINDEX logicalThreadStackSize;
    PINDEX rasThreadStackSize;
    PINDEX jitterThreadStackSize;

#ifdef H323_RTP_AGGREGATE
    PINDEX rtpAggregationSize;
    PHandleAggregator * rtpAggregator;
#endif

#ifdef H323_SIGNAL_AGGREGATE
    PINDEX signallingAggregationSize;
    PHandleAggregator * signallingAggregator;
#endif

    PThread::Priority channelThreadPriority;

    // Dynamic variables
    H323ListenerList listeners;
    H323Capabilities capabilities;
    H323Gatekeeper * gatekeeper;
    PString          gatekeeperPassword;

    H323ConnectionDict       connectionsActive;

    PMutex                   connectionsMutex;
    PMutex                   noMediaMutex;
    PStringSet               connectionsToBeCleaned;
    H323ConnectionsCleaner * connectionsCleaner;
    PSyncPoint               connectionsAreCleaned;

#ifndef DISABLE_CALLAUTH
    // Call Authentication
    PString EPSecurityUserName;    
    PString EPSecurityPassword;    
    BOOL isSecureCall;                     
    EPSecurityPolicy CallAuthPolicy;   
    H235AuthenticatorList EPAuthList;  
#endif

#ifdef H323_H460
        H460_FeatureSet features;
        BOOL disableH460;
#endif

#ifdef H323_AEC
    BOOL enableAEC;
#endif
};


#endif // __OPAL_H323EP_H

---