/* * h323pdu.h * * H.323 protocol handler * * Open H323 Library * * Copyright (c) 1998-2000 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: h323pdu.h,v $ * Revision 1.26  2000/07/15 09:50:49  robertj * Changed adding of Q.931 party numbers to only occur in SETUP. * * Revision 1.25  2000/06/21 08:07:39  robertj * Added cause/reason to release complete PDU, where relevent. * * Revision 1.24  2000/05/23 11:32:27  robertj * Rewrite of capability table to combine 2 structures into one and move functionality into that class *    allowing some normalisation of usage across several applications. * Changed H323Connection so gets a copy of capabilities instead of using endponts, allows adjustments *    to be done depending on the remote client application. * * Revision 1.23  2000/05/08 14:07:26  robertj * Improved the provision and detection of calling and caller numbers, aliases and hostnames. * * Revision 1.22  2000/05/08 05:05:43  robertj * Fixed bug in H.245 close logical channel timeout, thanks XuPeili. * * Revision 1.21  2000/05/02 04:32:24  robertj * Fixed copyright notice comment. * * Revision 1.20  2000/04/10 20:39:30  robertj * Added support for more sophisticated DTMF and hook flash user indication. * Added function to extract E164 address from Q.931/H.225 PDU. * * Revision 1.19  2000/03/25 02:00:39  robertj * Added adjustable caller name on connection by connection basis. * * Revision 1.18  2000/03/21 01:22:01  robertj * Fixed incorrect call reference code being used in originated call. * * Revision 1.17  1999/12/11 02:20:58  robertj * Added ability to have multiple aliases on local endpoint. * * Revision 1.16  1999/09/10 03:36:48  robertj * Added simple Q.931 Status response to Q.931 Status Enquiry * * Revision 1.15  1999/08/31 12:34:18  robertj * Added gatekeeper support. * * Revision 1.14  1999/08/25 05:07:49  robertj * File fission (critical mass reached). * * Revision 1.13  1999/07/16 06:15:59  robertj * Corrected semantics for tunnelled master/slave determination in fast start. * * Revision 1.12  1999/07/16 02:15:30  robertj * Fixed more tunneling problems. * * Revision 1.11  1999/07/15 14:45:35  robertj * Added propagation of codec open error to shut down logical channel. * Fixed control channel start up bug introduced with tunnelling. * * Revision 1.10  1999/07/10 02:51:53  robertj * Added mutexing in H245 procedures. * * Revision 1.9  1999/07/09 06:09:49  robertj * Major implementation. An ENORMOUS amount of stuff added everywhere. * * Revision 1.8  1999/06/25 10:25:35  robertj * Added maintentance of callIdentifier variable in H.225 channel. * * Revision 1.7  1999/06/14 05:15:56  robertj * Changes for using RTP sessions correctly in H323 Logical Channel context * * Revision 1.6  1999/06/13 12:41:14  robertj * Implement logical channel transmitter. * Fixed H245 connect on receiving call. * * Revision 1.5  1999/06/09 05:26:20  robertj * Major restructuring of classes. * * Revision 1.4  1999/06/06 06:06:36  robertj * Changes for new ASN compiler and v2 protocol ASN files. * * Revision 1.3  1999/04/26 06:14:47  craigs * Initial implementation for RTP decoding and lots of stuff * As a whole, these changes are called "First Noise" * * Revision 1.2  1999/01/16 02:35:04  robertj * GNi compiler compatibility. * * Revision 1.1  1999/01/16 01:30:58  robertj * Initial revision * */#ifndef __H323PDU_H#define __H323PDU_H#include <ptlib/sockets.h>#include "h323.h"#include "q931.h"#include "h225.h"#include "h245.h"/**Wrapper class for the H323 signalling channel. */class H323SignalPDU : public H225_H323_UserInformation{  PCLASSINFO(H323SignalPDU, H225_H323_UserInformation);  public:    H323SignalPDU();    H225_Facility_UUIE * BuildFacility(      const H323Connection & connection,      BOOL empty    );    H225_CallProceeding_UUIE & BuildCallProceeding(      const H323Connection & connection    );    H225_Alerting_UUIE & BuildAlerting(      const H323Connection & connection    );    H225_ReleaseComplete_UUIE & BuildReleaseComplete(      const H323Connection & connection    );    H225_Connect_UUIE & BuildConnect(      const H323Connection & connection    );    H225_Connect_UUIE & BuildConnect(      const H323Connection & connection,      const PIPSocket::Address & h245Address,      WORD port    );    H225_Setup_UUIE & BuildSetup(      const H323Connection & connection    );    H225_Setup_UUIE & BuildSetup(      const H323Connection & connection,      const PIPSocket::Address & destAddr,      WORD port    );    void BuildStatus(      int callRef,      BOOL fromDest    );    void PrintOn(ostream & strm) const;    BOOL Read(H323Transport & transport);    BOOL Write(H323Transport & transport);    const Q931 & GetQ931() const { return q931pdu; }    BOOL GetDestinationE164(PString & number) const;    void SetQ931Fields(      const H323Connection & connection,      BOOL insertPartyNumbers = FALSE    );  protected:    void BuildQ931();    // Even though we generally deal with the H323 protocol (H225) it is    // actually contained within a field of the Q931 protocol.    Q931 q931pdu;};/**Wrapper class for the H323 control channel. */class H323ControlPDU : public H245_MultimediaSystemControlMessage{  PCLASSINFO(H323ControlPDU, H245_MultimediaSystemControlMessage);  public:    H245_RequestMessage    & Build(H245_RequestMessage   ::Choices request);    H245_ResponseMessage   & Build(H245_ResponseMessage  ::Choices response);    H245_CommandMessage    & Build(H245_CommandMessage   ::Choices command);    H245_IndicationMessage & Build(H245_IndicationMessage::Choices indication);    H245_MasterSlaveDetermination & BuildMasterSlaveDetermination(      unsigned terminalType,      unsigned statusDeterminationNumber    );    H245_MasterSlaveDeterminationAck & BuildMasterSlaveDeterminationAck(      BOOL isMaster    );    H245_MasterSlaveDeterminationReject & BuildMasterSlaveDeterminationReject(      unsigned cause    );    H245_TerminalCapabilitySet & BuildTerminalCapabilitySet(      const H323Connection & connection,      unsigned sequenceNumber    );    H245_TerminalCapabilitySetAck & BuildTerminalCapabilitySetAck(      unsigned sequenceNumber    );    H245_TerminalCapabilitySetReject & BuildTerminalCapabilitySetReject(      unsigned sequenceNumber,      unsigned cause    );    H245_OpenLogicalChannel & BuildOpenLogicalChannel(      unsigned forwardLogicalChannelNumber    );    H245_RequestChannelClose & BuildRequestChannelClose(      unsigned channelNumber,      unsigned reason    );    H245_CloseLogicalChannel & BuildCloseLogicalChannel(      unsigned channelNumber    );    H245_OpenLogicalChannelAck & BuildOpenLogicalChannelAck(      unsigned channelNumber    );    H245_OpenLogicalChannelReject & BuildOpenLogicalChannelReject(      unsigned channelNumber,      unsigned cause    );    H245_OpenLogicalChannelConfirm & BuildOpenLogicalChannelConfirm(      unsigned channelNumber    );    H245_CloseLogicalChannelAck & BuildCloseLogicalChannelAck(      unsigned channelNumber    );    H245_RequestChannelCloseAck & BuildRequestChannelCloseAck(      unsigned channelNumber    );    H245_RequestChannelCloseReject & BuildRequestChannelCloseReject(      unsigned channelNumber    );    H245_RequestChannelCloseRelease & BuildRequestChannelCloseRelease(      unsigned channelNumber    );    H245_RequestMode & BuildRequestMode(      unsigned sequenceNumber    );    H245_RequestModeAck & BuildRequestModeAck(      unsigned sequenceNumber,      unsigned response    );    H245_RequestModeReject & BuildRequestModeReject(      unsigned sequenceNumber,      unsigned cause    );    H245_RoundTripDelayRequest & BuildRoundTripDelayRequest(      unsigned sequenceNumber    );    H245_RoundTripDelayResponse & BuildRoundTripDelayResponse(      unsigned sequenceNumber    );    H245_UserInputIndication & BuildUserInputIndication(      const PString & value    );    H245_UserInputIndication & BuildUserInputIndication(      char tone,               /// DTMF tone code      unsigned duration,       /// Duration of tone in milliseconds      unsigned logicalChannel, /// Logical channel number for RTP sync.      unsigned rtpTimestamp    /// RTP timestamp in logical channel sync.    );    H245_FunctionNotUnderstood & BuildFunctionNotUnderstood(      const H323ControlPDU & pdu    );    H245_EndSessionCommand & BuildEndSessionCommand(      unsigned reason    );};class H323RasPDU : public H225_RasMessage{  PCLASSINFO(H323RasPDU, H225_RasMessage);  public:    H225_GatekeeperRequest     & BuildGatekeeperRequest(unsigned seqNum);    H225_RegistrationRequest   & BuildRegistrationRequest(unsigned seqNum);    H225_UnregistrationRequest & BuildUnregistrationRequest(unsigned seqNum);    H225_UnregistrationConfirm & BuildUnregistrationConfirm(unsigned seqNum);    H225_LocationRequest       & BuildLocationRequest(unsigned seqNum);    H225_AdmissionRequest      & BuildAdmissionRequest(unsigned seqNum);    H225_DisengageRequest      & BuildDisengageRequest(unsigned seqNum);    H225_DisengageConfirm      & BuildDisengageConfirm(unsigned seqNum);    H225_BandwidthRequest      & BuildBandwidthRequest(unsigned seqNum);    H225_BandwidthConfirm      & BuildBandwidthConfirm(unsigned seqNum, unsigned bandWidth);    H225_BandwidthReject       & BuildBandwidthReject(unsigned seqNum, unsigned reason);    H225_InfoRequestResponse   & BuildInfoRequestResponse(unsigned seqNum);    H225_UnknownMessageResponse& BuildUnknownMessageResponse(unsigned seqNum);    BOOL Read(H323Transport & transport);    BOOL Write(H323Transport & transport) const;};void H323SetAliasAddresses(const PStringList & name, H225_ArrayOf_AliasAddress & aliases);void H323SetAliasAddress(const PString & name, H225_AliasAddress & alias);PString H323GetAliasAddressString(const H225_AliasAddress & alias);#endif // __H323PDU_H/////////////////////////////////////////////////////////////////////////////