开通博客赚积分
发布资源赚积分
分类

源码开发语言/平台
当前位置：首页 > 源码/资料 > 通讯/手机编程 > Symbian > 查看源码
rtspif.h
资源名称：142_61_thumb_advanced.rar　[点击查看]
上传用户：dangjiwu
上传日期：2013-07-19
资源大小：42019k
文件大小：44k
源码类别：

Symbian

开发平台：

Visual C++

rtspif.h：源码内容
  1. /* ***** BEGIN LICENSE BLOCK *****
  2.  * Source last modified: $Id: rtspif.h,v 1.14.4.1 2004/07/09 02:04:37 hubbe Exp $
  3.  * 
  4.  * Portions Copyright (c) 1995-2004 RealNetworks, Inc. All Rights Reserved.
  5.  * 
  6.  * The contents of this file, and the files included with this file,
  7.  * are subject to the current version of the RealNetworks Public
  8.  * Source License (the "RPSL") available at
  9.  * http://www.helixcommunity.org/content/rpsl unless you have licensed
  10.  * the file under the current version of the RealNetworks Community
  11.  * Source License (the "RCSL") available at
  12.  * http://www.helixcommunity.org/content/rcsl, in which case the RCSL
  13.  * will apply. You may also obtain the license terms directly from
  14.  * RealNetworks.  You may not use this file except in compliance with
  15.  * the RPSL or, if you have a valid RCSL with RealNetworks applicable
  16.  * to this file, the RCSL.  Please see the applicable RPSL or RCSL for
  17.  * the rights, obligations and limitations governing use of the
  18.  * contents of the file.
  19.  * 
  20.  * Alternatively, the contents of this file may be used under the
  21.  * terms of the GNU General Public License Version 2 or later (the
  22.  * "GPL") in which case the provisions of the GPL are applicable
  23.  * instead of those above. If you wish to allow use of your version of
  24.  * this file only under the terms of the GPL, and not to allow others
  25.  * to use your version of this file under the terms of either the RPSL
  26.  * or RCSL, indicate your decision by deleting the provisions above
  27.  * and replace them with the notice and other provisions required by
  28.  * the GPL. If you do not delete the provisions above, a recipient may
  29.  * use your version of this file under the terms of any one of the
  30.  * RPSL, the RCSL or the GPL.
  31.  * 
  32.  * This file is part of the Helix DNA Technology. RealNetworks is the
  33.  * developer of the Original Code and owns the copyrights in the
  34.  * portions it created.
  35.  * 
  36.  * This file, and the files included with this file, is distributed
  37.  * and made available on an 'AS IS' basis, WITHOUT WARRANTY OF ANY
  38.  * KIND, EITHER EXPRESS OR IMPLIED, AND REALNETWORKS HEREBY DISCLAIMS
  39.  * ALL SUCH WARRANTIES, INCLUDING WITHOUT LIMITATION, ANY WARRANTIES
  40.  * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, QUIET
  41.  * ENJOYMENT OR NON-INFRINGEMENT.
  42.  * 
  43.  * Technology Compatibility Kit Test Suite(s) Location:
  44.  *    http://www.helixcommunity.org/content/tck
  45.  * 
  46.  * Contributor(s):
  47.  * 
  48.  * ***** END LICENSE BLOCK ***** */
  50. #ifndef _RTSPIF_H_
  51. #define _RTSPIF_H_
  53. //XXX...the following 2 includes should go away
  54. #include "hxpends.h"
  55. #include "hxcomm.h"
  56. // Don't remove this include!
  57. #include "hxstring.h"
  58. #include "basepkt.h"
  59. #include "servrsnd.h"
  61. struct IHXTCPSocket;
  62. class RTSPServerState;
  63. class RTSPClientState;
  64. class RawPacketFilter;
  66. struct IHXBuffer;
  67. class CHXSimpleList;
  68. class RTSPTransport;
  69. class RTSPStreamHandler;
  70. struct IHXPacket;
  71. struct IHXValues;
  72. struct IHXPacketResend;
  73. class BasePacket;
  74. _INTERFACE IHXFileFormatHeaderAdvise;
  76. /* client initialization flags */
  77. #define RTSP_INIT_NO_AUTHORIZATION 0
  78. #define RTSP_INIT_HXPRIVATE_AUTHORIZATION 1
  79. #define RTSP_INIT_WWW_AUTHORIZATION 2
  81. typedef enum _RTSPTransportSubTypeEnum
  82. {
  83.     RTSP_SUBTR_NONE = 0, /* unknown */
  84.     RTSP_SUBTR_UDP = 1, /* udp */
  85.     RTSP_SUBTR_TCP = 2, /* tcp */
  86.     RTSP_SUBTR_MCAST = 3, /* multicast */
  87.     RTSP_SUBTR_NULLSET = 4 /* null setup */
  88. } RTSPTransportSubTypeEnum;
  90. typedef enum _RTSPTransportTypeEnum
  91. {
  92.     RTSP_TR_NONE        = 0,    /* No transport */
  93.     RTSP_TR_RDT_MCAST,          /* x-real-rdt/mcast */
  94.     RTSP_TR_RDT_UDP,            /* x-real-rdt/udp */
  95.     RTSP_TR_RDT_TCP,            /* x-real-rdt/tcp */
  96.     RTSP_TR_TNG_UDP,            /* x-pn-tng/udp, Supported, Deprecated */
  97.     RTSP_TR_TNG_TCP,            /* x-pn-tng/tcp, Supported, Deprecated */
  98.     RTSP_TR_TNG_MCAST,          /* x-pn-tng/mcast, Not Supported / Deprecated */
  99.     RTSP_TR_RTP_UDP,            /* rtp/avp/udp;unicast */
  100.     RTSP_TR_RTP_MCAST,          /* rtp/avp/udp;multicast */
  101.     RTSP_TR_RTP_TCP,            /* rtp/avp/tcp;unicast */
  102.     RTSP_TR_RTCP,               /* Not valid in SETUP */
  103.     RTSP_TR_NULLSET,            /* x-real-nullsetup, for RealProxy */
  104.     RTSP_TR_BCNG_UDP,
  105.     RTSP_TR_BCNG_MCAST,
  106.     RTSP_TR_BCNG_TCP,
  107.     RTSP_TR_LAST
  108. } RTSPTransportTypeEnum;
  110. typedef enum _RTSPTransportModeEnum
  111. {
  112.     RTSP_TRMODE_NONE    = 0,    /* No mode, uninitialized */
  113.     RTSP_TRMODE_PLAY,           /* mode=play, default per 2326 */
  114.     RTSP_TRMODE_RECORD,         /* mode=record */
  115.     RTSP_TRMODE_OTHER           /* unrecognized */
  116. } RTSPTransportModeEnum;
  118. typedef enum _RTSPPrerollTypeEnum
  119. {
  120.     RTSP_PREROLL_NONE            = 0, /* unknown */
  121.     RTSP_PREROLL_PREDECBUFPERIOD = 1, /* x-initpredecbufperiod */
  122. } RTSPPrerollTypeEnum;
  124. /*
  125.  * Various macros for determining the type of transport:
  126.  *
  127.  *   IS_CLIENT_TRANSPORT: a player transport (eg. not server-to-server)
  128.  *   IS_RDT_TRANSPORT   : an RDT or TNG transport
  129.  *   IS_RTP_TRANSPORT   : an RTP (rfc1889) transport
  130.  *   IS_TCP_TRANSPORT   : any TCP transport (client or not)
  131.  *   IS_MCAST_TRANSPORT : any multicast transport (client or not)
  132.  *
  133.  * Note that nullsetup does not fall into any of these categories.
  134.  */
  136. #define IS_CLIENT_TRANSPORT(t) 
  137.     ((t) >= RTSP_TR_RDT_MCAST && (t) <= RTSP_TR_RTCP)
  139. #define IS_RDT_TRANSPORT(t) 
  140.     ((t) >= RTSP_TR_RDT_MCAST && (t) <= RTSP_TR_TNG_MCAST)
  142. #define IS_RTP_TRANSPORT(t) 
  143.     ((t) >= RTSP_TR_RTP_UDP && (t) <= RTSP_TR_RTCP)
  145. #define IS_TCP_TRANSPORT(t) 
  146.     ((t) == RTSP_TR_RDT_TCP || (t) == RTSP_TR_TNG_TCP || 
  147.      (t) == RTSP_TR_RTP_TCP || (t) == RTSP_TR_BCNG_TCP)
  149. #define IS_MCAST_TRANSPORT(t) 
  150.     ((t) == RTSP_TR_RDT_MCAST || (t) == RTSP_TR_TNG_MCAST || 
  151.      (t) == RTSP_TR_RTP_MCAST || (t) == RTSP_TR_BCNG_MCAST)
  153. enum  /* parameter types */
  154. {
  155.     RTSP_PARAM_STRING = 0,
  156.     RTSP_PARAM_LONG = 1,
  157.     RTSP_PARAM_BINARY = 2
  158. };
  160. enum RTPInfoEnum
  161. {
  162.     RTPINFO_ERROR, /* error */
  163.     RTPINFO_SEQ, /* only Seq found */
  164.     RTPINFO_RTPTIME, /* only rtptime found */    
  165.     RTPINFO_SEQ_RTPTIME, /* both seq & rtptime found */
  166.     RTPINFO_EMPTY /* neither seq nor rtptime found */
  167. };
  169. typedef enum
  170. {
  171.     RTSPMEDIA_TYPE_UNKNOWN,
  172.     RTSPMEDIA_TYPE_AUDIO,
  173.     RTSPMEDIA_TYPE_VIDEO,
  174.     RTSPMEDIA_TYPE_APP
  175. } RTSPMediaType;
  177. typedef struct _RTSPASMRule
  178. {
  179.     UINT16 m_ruleNumber;
  180.     UINT16 m_streamNumber;
  181. } RTSPASMRule;
  183. typedef struct _RTSPSubscription
  184. {
  185.     UINT16 m_ruleNumber;
  186.     UINT16 m_streamNumber;
  187.     BOOL m_bIsSubscribe; // Only used in RuleChanges()
  188. } RTSPSubscription;
  190. typedef struct _RTSPStreamInfo
  191. {
  192.     _RTSPStreamInfo()
  193. : m_rtpPayloadType(101)
  194. , m_bHasMarkerRule(0)
  195. , m_markerRule(1)
  196. , m_bHasRTCPRule(0)
  197. , m_ulPayloadWirePacket(0)
  198. , m_RTCPRule(1)
  199. , m_sampleRate(1)
  200. , m_sampleSize(1)
  201. , m_RTPFactor(1)
  202. , m_HXFactor(1)
  203. , m_bIsLive(0)
  204. , m_bExtensionSupport(0)
  205. , m_bActive(TRUE)
  206. , m_bForceRTP(FALSE)
  207. , m_bHasOutOfOrderTS(FALSE)
  208. , m_ulAvgBitRate(0)
  209. , m_ulRtpRRBitRate((UINT32)-1)
  210. , m_ulRtpRSBitRate((UINT32)-1)
  211.         , m_bRealMedia(FALSE)
  212.     {}  
  213.     
  214.     UINT16 m_streamNumber;
  215.     BOOL m_bNeedReliablePackets;
  216.     CHXString m_streamControl;
  217.     UINT16 m_sPort;
  218.     BOOL        m_bForceRTP;
  219.     BOOL m_bHasOutOfOrderTS;
  220.     RTSPMediaType m_eMediaType;
  221.     // rest of them are only for RTP
  222.     INT16 m_rtpPayloadType;
  223.     BOOL m_bHasMarkerRule;
  224.     UINT16 m_markerRule;
  225.     BOOL m_bHasRTCPRule;
  226.     UINT32 m_ulPayloadWirePacket;
  227.     BOOL m_bIsSyncMaster;
  228.     UINT16 m_RTCPRule;
  229.     UINT32      m_sampleRate;
  230.     UINT32      m_sampleSize;
  231.     UINT32 m_RTPFactor;
  232.     UINT32 m_HXFactor;
  233.     BOOL m_bIsLive;
  234.     BOOL m_bExtensionSupport;
  235.     BOOL m_bActive;
  236.     UINT32      m_ulAvgBitRate;
  237.     UINT32      m_ulRtpRRBitRate;
  238.     UINT32      m_ulRtpRSBitRate;
  239.     BOOL        m_bRealMedia;
  240. } RTSPStreamInfo;
  242. typedef struct _RTSPSocketInfo
  243. {
  244.     IHXTCPSocket* m_pSocket;
  245.     UINT32 m_ulForeignAddr;
  246. } RTSPSocketInfo;
  248. /* 
  249.  * XXXBAB - compatibility struct until I change the interface
  250.  * to SendSetupRequest
  251.  */
  252. class RTSPTransportType
  253. {
  254. public:
  255.     RTSPTransportType() :
  256.         m_lTransportType(RTSP_TR_NONE),
  257.         m_Mode(RTSP_TRMODE_NONE),
  258.         m_sPort(0),
  259.         m_streamNumber(0),
  260.         m_ulBufferDepth(0),
  261.         m_RTSPDestinationAddress(NULL)
  262.     {
  263.         // Empty
  264.     }
  265.     RTSPTransportType(const RTSPTransportType& other)
  266.     {
  267.         *this = other;
  268.     }
  269.     ~RTSPTransportType()
  270.     {
  271.         delete[] m_RTSPDestinationAddress;
  272.     }
  273.     RTSPTransportType& operator=(const RTSPTransportType& other)
  274.     {
  275.         m_lTransportType = other.m_lTransportType;
  276.         m_Mode = other.m_Mode;
  277.         m_sPort = other.m_sPort;
  278.         m_streamNumber = other.m_streamNumber;
  279.         m_ulBufferDepth = other.m_ulBufferDepth;
  280.         m_RTSPDestinationAddress = other.m_RTSPDestinationAddress ? 
  281.             new_string(other.m_RTSPDestinationAddress) : NULL;
  282.         return *this;
  283.     }
  284.     RTSPTransportTypeEnum       m_lTransportType;
  285.     RTSPTransportModeEnum       m_Mode;
  286.     UINT16                      m_sPort;
  287.     UINT16                      m_streamNumber;
  288.     UINT32                      m_ulBufferDepth;
  289.     char*                       m_RTSPDestinationAddress;
  290. };
  292. DECLARE_INTERFACE_(IHXRTSPServerProtocolResponse, IUnknown)
  293. {
  294.     /*
  295.      * IUnknown methods
  296.      */
  298.     STDMETHOD(QueryInterface) (THIS_
  299. REFIID riid,
  300. void** ppvObj) PURE;
  302.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  304.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  306.     /************************************************************************ 
  307.      *  Method:
  308.      *      IHXRTSPServerProtocolResponse::HandleAuthentication
  309.      *  
  310.      * Purpose:
  311.      *     Called to indicate success/failure of authentication
  312.      */
  313. /*XXXkshoop Removed, it was deadweight
  314.     STDMETHOD(HandleAuthentication) (THIS_
  315. HX_RESULT status
  316.                                 ) PURE;
  317. */
  318.     /*************************************************************************
  319.      *  Method:
  320.      *      IHXRTSPServerProtocolResponse::HandleWWWAuthentication
  321.      *
  322.      *  Purpose:
  323.      *      Called when a WWW-Authenticate header is received.
  324.      */
  325. /*XXXkshoop Removed, it was deadweight
  326.     STDMETHOD(HandleWWWAuthentication)  (THIS_
  327.  IHXValues* pAuthValues
  328.  ) PURE;
  329. */
  331.     /************************************************************************
  332.      * Method:
  333.      *     IHXRTSPServerProtocolResponse::HandleStreamDescriptionRequest
  334.      * Purpose:
  335.      *     Called to get stream description for an URL
  336.      */
  338.     STDMETHOD(HandleStreamDescriptionRequest)
  339. (THIS_
  340. const char* pURL,
  341. IHXValues* pRequestHeaders,
  342. const char* pSessionID,
  343. BOOL bUseRTP
  344. ) PURE;
  346.     STDMETHOD(HandleStreamRecordDescriptionRequest)
  347. (THIS_
  348. const char* pURL,
  349. const char* pSessionID,
  350. IHXValues* pFileHeader,
  351. CHXSimpleList* pHeaders,
  352. IHXValues* pRequestHeaders
  353. ) PURE;
  355.     /************************************************************************
  356.      * Method:
  357.      *     IHXRTSPServerProtocolResponse::HandleSetupRequest
  358.      * Purpose:
  359.      *     Called to indicate success/failure of setting up a transport
  360.      */
  361.     STDMETHOD(HandleSetupRequest) (THIS_
  362. HX_RESULT status
  363. ) PURE;
  365.     /************************************************************************
  366.      * Method:
  367.      *     IHXRTSPServerProtocolResponse::HandleSetParameterRequest
  368.      * Purpose:
  369.      *     Called to tell the client to set a parameter
  370.      */
  371.     STDMETHOD(HandleSetParameterRequest) (THIS_
  372. UINT32 lParamType,
  373. const char* pParamName,
  374. IHXBuffer* pParamValue
  375. ) PURE;
  376.     
  377.     STDMETHOD(HandleSetParameterRequest) (THIS_
  378.      const char* pSessionID,
  379.      const char* pParamName,
  380. const char* pParamValue,
  381. const char* pContent) PURE;
  383.     STDMETHOD(HandleSetParameterResponse) (THIS_
  384.      HX_RESULT status
  385. ) PURE;
  387.     /************************************************************************
  388.      * Method:
  389.      *     IHXRTSPServerProtocolResponse::HandleGetParameterRequest
  390.      * Purpose:
  391.      *     Called to tell the client to get a parameter
  392.      */
  393.     STDMETHOD(HandleGetParameterRequest) (THIS_
  394. UINT32 lParamType,
  395. const char* pParamName,
  396. IHXBuffer** pParamValue
  397. ) PURE;
  399.     STDMETHOD(HandleGetParameterResponse) (THIS_
  400.      HX_RESULT status,
  401.      IHXBuffer* pParamValue
  402. ) PURE;
  404.     /************************************************************************
  405.      * Method:
  406.      *     IHXRTSPServerProtocolResponse::HandlePlayRequest
  407.      * Purpose:
  408.      *     Called to start packet delivery - lFrom is start time in msecs,
  409.      *      lTo is end time in msecs.
  410.      */
  411.     STDMETHOD(HandlePlayRequest) (THIS_
  412. UINT32 lFrom,
  413. UINT32 lTo,
  414. CHXSimpleList* pSubscriptions,
  415.     /*RTSPSubscription*/
  416. const char* pSessionID
  417. ) PURE;
  419.     STDMETHOD(HandleRecordRequest) (THIS_
  420.      const char* pSessionID) PURE; 
  422.     /************************************************************************
  423.      * Method:
  424.      *     IHXRTSPServerProtocolResponse::HandlePauseRequest
  425.      * Purpose:
  426.      *     Called to pause packet delivery 
  427.      */
  428.     STDMETHOD(HandlePauseRequest) (THIS_
  429.      const char* pSessionID) PURE;
  431.     /************************************************************************
  432.      * Method:
  433.      *     IHXRTSPServerProtocolResponse::HandleResumeRequest
  434.      * Purpose:
  435.      *     Called to resume packet delivery 
  436.      */
  437.     STDMETHOD(HandleResumeRequest) (THIS_
  438.      const char* pSessionID) PURE;
  440.     /************************************************************************
  441.      * Method:
  442.      *     IHXRTSPServerProtocolResponse::HandleTeardownResponse
  443.      * Purpose:
  444.      *     Called to confirm release of connection resources
  445.      */
  446.     STDMETHOD(HandleTeardownResponse) (THIS_
  447. HX_RESULT status
  448. ) PURE;
  450.     STDMETHOD(HandleTeardownRequest) (THIS_
  451.      const char* pSessionID) PURE;
  453.     /************************************************************************
  454.      * Method:
  455.      *     IHXRTSPServerProtocolResponse::HandlePacket
  456.      * Purpose:
  457.      *     Called when transport layer has received a data packet
  458.      */
  459.     STDMETHOD(HandlePacket) (THIS_
  460.      HX_RESULT status,
  461. const char* pSessionID,
  462. IHXPacket* pPacket
  463. ) PURE;
  465.     STDMETHOD(HandleSubscribe) (THIS_
  466.      CHXSimpleList* pSubscriptions,
  467. /*RTSPSubscription*/
  468. const char* pSessionID
  469. ) PURE;
  471.     STDMETHOD(HandleUnsubscribe) (THIS_
  472.      CHXSimpleList* pUnsubscriptions,
  473. /*RTSPSubscription*/
  474. const char* pSessionID
  475. ) PURE;
  477.     STDMETHOD(HandleSubscriptionDone) (THIS_
  478.     REF(UINT32) ulAddress,
  479.     REF(UINT32) ulSourcePort,
  480.     REF(UINT32) ulPort,
  481.     const char* pSessionID,
  482.     REF(RTSPStreamHandler*) pHandler)
  483.     { return HXR_NOTIMPL; }
  485.     STDMETHOD(HandleBackChannel) (THIS_
  486. IHXPacket* pPacket,
  487. const char* pSessionID
  488. ) PURE;
  491.     STDMETHOD(HandleBWReport) (THIS_
  492.      HX_RESULT status,
  493. const char* pSessionID,
  494. INT32 aveBandwidth,
  495. INT32 packetLoss,
  496. INT32 bandwidthWanted
  497. ) PURE;
  499.     STDMETHOD(HandlePlayerStats) (THIS_
  500.      const char* pStats,
  501. const char* pSessionID
  502. ) PURE;
  504.     STDMETHOD(HandleSessionHeaders) (THIS_
  505.      IHXValues* pSessionHeaders
  506. ) PURE;
  508.     STDMETHOD(HandleSpeedParam) (THIS_
  509. const char* pSessionID,
  510.      FIXED32 fSpeed
  511. ) PURE;
  513.     STDMETHOD(HandleScaleParam) (THIS_
  514. const char* pSessionID,
  515.      FIXED32 fScale
  516. ) PURE;
  518.     /************************************************************************
  519.      * Method:
  520.      *     IHXRTSPServerProtocolResponse::HandleProtocolError
  521.      * Purpose:
  522.      *     Called to notify client of protocol error conditions
  523.      */
  524.     STDMETHOD(HandleProtocolError) (THIS_
  525.      HX_RESULT status
  526. ) PURE;
  528.     STDMETHOD(AddSession) (THIS_
  529.      const char* pURLText,
  530. UINT32 ulSeqNo,
  531. REF(CHXString) sessionID,
  532.                                         BOOL bRetainEntityForSetup) PURE;
  533.     
  534.     STDMETHOD(AddSessionWithID) (THIS_
  535.      const char* pURLText,
  536. UINT32 ulSeqNo,
  537.                                         REF(CHXString) sessionID,
  538.                                         BOOL bRetainEntityForSetup) PURE;
  540.     STDMETHOD(AddTransport) (THIS_
  541. RTSPTransport* pTransport,
  542.      const char* pSessionID,
  543. UINT16 streamNumber,
  544. UINT32 ulReliability) PURE;
  546.     STDMETHOD(SetupTransports) (THIS_
  547. const char* pSessionID) PURE;
  549.     STDMETHOD(HandleLimitBandwidthByDropping)
  550. (THIS_
  551. UINT16 streamNumber,
  552. const char* pSessionID,
  553. UINT32 ulBandwidthLimit) PURE;
  555.     STDMETHOD(HandleSetDeliveryBandwidth)
  556. (THIS_
  557.  UINT32 ulBackOff,
  558.  const char* pSessionID,
  559.  UINT32 ulBandwidth) PURE;
  561.     STDMETHOD(HandleStreamDone) (THIS_
  562. HX_RESULT status,
  563. UINT16 uStreamNumber) PURE;
  565.     STDMETHOD(GenerateNewSessionID) (THIS_
  566. REF(CHXString) sessionID,
  567. UINT32 ulSeqNo) PURE;
  569.     STDMETHOD(HandleRetainEntityForSetup)
  570. (THIS_
  571. const char* pSessionID,
  572. BOOL bRequired) PURE;
  574.     STDMETHOD(SetMidBox)
  575. (THIS_
  576. const char* pSessionID,
  577. BOOL bIsMidBox) PURE;
  578. };
  579.      
  581. DECLARE_INTERFACE_(IHXRTSPServerProtocol, IUnknown)
  582. {
  583.     /*
  584.      * IUnknown methods
  585.      */
  587.     STDMETHOD(QueryInterface) (THIS_
  588. REFIID riid,
  589. void** ppvObj) PURE;
  591.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  593.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  595.     /************************************************************************
  596.      * Method:
  597.      *     IHXRTSPServerProtocol::Init
  598.      * Purpose:
  599.      *     Initialize context pointer
  600.      */
  601.     STDMETHOD(Init) (THIS_
  602.      IUnknown* pContext
  603. ) PURE;
  605.     STDMETHOD(SetBuildVersion) (THIS_
  606.      const char* pVersionString) PURE;
  608.     STDMETHOD(SetOptionsRespHeaders)(THIS_
  609.     IHXValues* pHeaders) PURE;
  611.     /************************************************************************
  612.      * Method:
  613.      *     IHXRTSPServerProtocol::Done
  614.      * Purpose:
  615.      *     Close protocol objects
  616.      */
  617.     STDMETHOD(Done) (THIS) PURE;
  619.     /************************************************************************
  620.      * Method:
  621.      *     IHXRTSPServerProtocol::SetControl
  622.      * Purpose:
  623.      *     Set control channel and response handler for protocol
  624.      */
  625.     STDMETHOD(SetControl) (THIS_
  626. IHXTCPSocket* pCtrl,
  627.                                 IHXRTSPServerProtocolResponse* pResp,
  628.                                 IHXBuffer* pBuffer) PURE;
  630.     STDMETHOD(AddSession) (THIS_
  631.      const char* pSessionID,
  632. const char* pURL,
  633. UINT32 ulSeqNo) PURE;
  635.     /************************************************************************
  636.      * Method:
  637.      *     IHXRTSPServerProtocol::SetControl
  638.      * Purpose:
  639.      *     Set response handler for protocol
  640.      */
  641.     STDMETHOD(SetResponse) (THIS_
  642. IHXTCPSocket* pCtrl,
  643.      IHXRTSPServerProtocolResponse* pResp) PURE;
  645.     /************************************************************************
  646.      * Method:
  647.      *     IHXRTSPServerProtocol::Disconnect
  648.      * Purpose:
  649.      *     Disconnect client session
  650.      */
  651.     STDMETHOD(Disconnect) (THIS_
  652. const char* pSessionID) PURE;
  654.     /************************************************************************
  655.      * Method:
  656.      *     IHXRTSPServerProtocol::SendAlertRequest
  657.      * Purpose:
  658.      *     Send alert request
  659.      */
  660.     STDMETHOD(SendAlertRequest) (THIS_
  661. const char* pSessionID,
  662. INT32 lAlertNumber,
  663. const char* pAlertText) PURE;
  665.     STDMETHOD(SendKeepAlive) (THIS) PURE;
  667.     /************************************************************************
  668.      * Method:
  669.      *     IHXRTSPServerProtocol::SendTeardownRequest
  670.      * Purpose:
  671.      *     Send request to release connection resources
  672.      */
  673.     STDMETHOD(SendTeardownRequest) (THIS_
  674.      const char* pSessionID) PURE;
  676.     STDMETHOD(SendRedirectRequest) (THIS_
  677. const char* pSessionID,
  678.      const char* pURL,
  679. UINT32 mSecsFromNow) PURE;
  681.     STDMETHOD(SendSetParameterRequest)  (THIS_
  682.                                         const char* pSessionID,
  683.                                         const char* pURL,
  684.                                         const char* pParamName,
  685.                                         IHXBuffer* pParamValue) PURE;
  686.     STDMETHOD(SendSetParameterRequest)  (THIS_
  687.      const char* pSessionID,
  688. const char* pURL,
  689. const char* pParamName,
  690. const char* pParamValue,
  691. const char* pMimeType,
  692. const char* pContent) PURE;
  693.     STDMETHOD(SendGetParameterRequest) (THIS_
  694.      UINT32 lParamType,
  695. const char* pParamName
  696. ) PURE;
  698.     /************************************************************************
  699.      * Method:
  700.      *     IHXRTSPServerProtocol::SetupSequenceNumberResponse
  701.      * Purpose:
  702.      *     Setup the sequence number response header
  703.      */
  704.     STDMETHOD(SetupSequenceNumberResponse) (THIS_
  705. const char* pSessionID
  706. ) PURE;
  708.     /************************************************************************
  709.      * Method:
  710.      *     IHXRTSPServerProtocol::SendStreamResponse
  711.      * Purpose:
  712.      *     Send stream Setup or Describe response to client
  713.      */
  714.     STDMETHOD(SendStreamResponse)
  715.     (
  716. THIS_
  717. HX_RESULT status,
  718. const char* pSessionID,
  719. IHXValues* pFileHeader,
  720. CHXSimpleList* pHeaders,
  721. IHXValues* pOptionalValues,
  722. IHXValues* pResponseHeaders,
  723. BOOL bMulticastOK,
  724. BOOL bRequireMulticast,
  725. BOOL bIsRealDataType
  726.     ) PURE;
  728.     STDMETHOD(SendStreamRecordDescriptionResponse)
  729.     (
  730. HX_RESULT status,
  731. const char* pSessionID,
  732. IHXValues* pAuthValues,
  733. IHXValues* pResponseHeaders
  734.     ) PURE;
  736.     /************************************************************************
  737.      * Method:
  738.      *     IHXRTSPServerProtocol::SendPacket
  739.      * Purpose:
  740.      *     Send data packet to client
  741.      */
  742.     STDMETHOD(SendPacket) (THIS_ 
  743.  BasePacket* pPacket,
  744.  const char* pSessionID
  745. ) PURE;
  747.     STDMETHOD(StartPackets) (THIS_
  748. UINT16 uStreamNumber,
  749. const char* pSessionID
  750. ) PURE;
  752.     STDMETHOD(StopPackets) (THIS_
  753. UINT16 uStreamNumber,
  754. const char* pSessionID
  755. ) PURE;
  757.     /************************************************************************
  758.      * Method:
  759.      *     IHXRTSPServerProtocol::SetPacketResend
  760.      * Purpose:
  761.      *     Set pointer to object which will handle resending of packets
  762.      */
  763.     STDMETHOD(SetPacketResend) (THIS_
  764. IHXPacketResend* pPacketResend,
  765. const char* pSessionID
  766. ) PURE;
  768.     STDMETHOD(SendRTTResponse) (THIS_
  769.      UINT32 secs,
  770. UINT32 uSecs,
  771. const char* pSessionID
  772. ) PURE;
  774.     STDMETHOD(SendCongestionInfo) (THIS_
  775.      INT32 xmitMultiplier,
  776. INT32 recvMultiplier,
  777. const char* pSessionID
  778. ) PURE;
  780.     STDMETHOD(SendStreamDone) (THIS_
  781.      UINT16 streamID, 
  782. const char* pSessionID
  783. ) PURE;
  785.     STDMETHOD(SetConnectionTimeout) (THIS_
  786. UINT32 uSeconds
  787. ) PURE;
  789.     STDMETHOD(SetFFHeaderAdvise) (THIS_
  790. IHXFileFormatHeaderAdvise* pAdvise,
  791.                                         const char * pSessionID
  792. ) PURE;
  794. };
  796. DECLARE_INTERFACE_(IHXRTSPServerSessionManagerResponse, IUnknown)
  797. {
  798.     /*
  799.      * IUnknown methods
  800.      */
  802.     STDMETHOD(QueryInterface) (THIS_
  803. REFIID riid,
  804. void** ppvObj) PURE;
  806.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  808.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  810.     STDMETHOD(GetSessionInstanceDone) (THIS_
  811. HX_RESULT status,
  812.      IHXRTSPServerProtocol* pProt,
  813.      IHXTCPSocket* pSocket,
  814.      IHXBuffer* pBuffer) PURE;
  815. };
  817. class RTSPResponseMessage;
  819. DECLARE_INTERFACE_(IHXRTSPClientProtocolResponse, IUnknown)
  820. {
  821.     /*
  822.      * IUnknown methods
  823.      */
  825.     STDMETHOD(QueryInterface) (THIS_
  826. REFIID riid,
  827. void** ppvObj) PURE;
  829.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  831.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  833.     /*
  834.      * IHXRTSPClientProtocolResponse methods
  835.      */
  837.     STDMETHOD(InitDone) (THIS_
  838.      HX_RESULT status
  839. ) PURE;
  841.     /************************************************************************
  842.      * Method:
  843.      *     IHXRTSPClientProtocolResponse::HandleAuthentication
  844.      * Purpose:
  845.      *     Called to indicate success/failure of authentication
  846.      */
  847.     STDMETHOD(HandleOptionsResponse)
  848.     (
  849. THIS_
  850. HX_RESULT status,
  851. IHXValues* pHeaders
  852.     ) PURE;
  854.     STDMETHOD(HandleWWWAuthentication) (THIS_
  855.  HX_RESULT status,
  856.  IHXValues* pAuthInfo
  857.                                 ) PURE;
  859.     /************************************************************************
  860.      * Method:
  861.      *     IHXRTSPClientProtocolResponse::HandleStreamDescriptionResponse
  862.      * Purpose:
  863.      *     Called to handle a stream description for an URL
  864.      */
  865.     STDMETHOD(HandleStreamDescriptionResponse)
  866.     (
  867. THIS_
  868. HX_RESULT status,
  869. IHXValues* pFileHeader,
  870. CHXSimpleList* pStreams,
  871. IHXValues* pResponseHeaders
  872.     ) PURE;
  874.     STDMETHOD(HandleStreamRecordDescriptionResponse)
  875. (THIS_
  876. HX_RESULT status,
  877. IHXValues* pResponseHeaders
  878. ) PURE;
  880.     /************************************************************************
  881.      * Method:
  882.      *     IHXRTSPClientProtocolResponse::HandleSetupResponse
  883.      * Purpose:
  884.      *     Called to indicate success/failure of setting up a transport
  885.      */
  886.     STDMETHOD(HandleSetupResponse) (THIS_
  887. HX_RESULT status
  888. ) PURE;
  890.     /************************************************************************
  891.      * Method:
  892.      *     IHXRTSPClientProtocolResponse::HandlePlayResponse
  893.      * Purpose:
  894.      *     Called to indicate play status
  895.      */
  896.     STDMETHOD(HandlePlayResponse) (THIS_
  897. HX_RESULT status
  898. ) PURE;
  900.     STDMETHOD(HandleRecordResponse) (THIS_
  901. HX_RESULT status
  902. ) PURE;
  904.     /************************************************************************
  905.      * Method:
  906.      *     IHXRTSPClientProtocolResponse::HandleTeardownResponse
  907.      * Purpose:
  908.      *     Called to confirm release of connection resources
  909.      */
  910.     STDMETHOD(HandleTeardownResponse) (THIS_
  911. HX_RESULT status
  912. ) PURE;
  913.     
  914.     STDMETHOD(HandleSetParameterRequest) (THIS_
  915. UINT32 lParamType,
  916. const char* pParamName,
  917. IHXBuffer* pParamValue
  918. ) PURE;
  919.     
  920.     STDMETHOD(HandleSetParameterRequest) (THIS_
  921.      const char* pParamName,
  922. const char* pParamValue,
  923. const char* pContent) PURE;
  924.     
  925.     STDMETHOD(HandleSetParameterResponse) (THIS_
  926.      HX_RESULT status
  927. ) PURE;
  929.     STDMETHOD(HandleSetParameterResponseWithValues) (THIS_
  930.      HX_RESULT status,
  931. IHXValues* pValues
  932. )
  933.     { return HandleSetParameterResponse(status);};
  935.     STDMETHOD(HandleGetParameterRequest) (THIS_
  936. UINT32 lParamType,
  937. const char* pParamName,
  938. IHXBuffer** pParamValue
  939. ) PURE;
  941.     STDMETHOD(HandleGetParameterResponse) (THIS_
  942. HX_RESULT status,
  943. IHXBuffer* pParamValue
  944. ) PURE;
  946.     STDMETHOD(HandleRedirectRequest) (THIS_
  947.      const char* pURL,
  948. UINT32 msecsFromNow
  949. ) PURE;
  951.     STDMETHOD(HandleUseProxyRequest) (THIS_
  952. const char* pProxyURL
  953. )
  954.     {
  955. // default behavior is NOTIMPL
  956. return HXR_NOTIMPL;
  957.     }
  959.     /************************************************************************
  960.      * Method:
  961.      *     IHXRTSPClientProtocolResponse::HandleAlertRequest
  962.      * Purpose:
  963.      *     Called to notify client of alert request
  964.      */
  965.     STDMETHOD(HandleAlertRequest) (THIS_
  966. HX_RESULT status,
  967. INT32 lAlertNumber,
  968. const char* pAlertText
  969. ) PURE;
  971.     /************************************************************************
  972.      * Method:
  973.      *     IHXRTSPClientProtocolResponse::HandlePacket
  974.      * Purpose:
  975.      *     Called when transport layer has received a data packet
  976.      */
  977.     STDMETHOD(HandlePacket) (THIS_
  978.      HX_RESULT status,
  979. const char* pSessionID,
  980. IHXPacket* pPacket
  981. ) PURE;
  983.     /************************************************************************
  984.      * Method:
  985.      *     IHXRTSPClientProtocolResponse::HandleProtocolError
  986.      * Purpose:
  987.      *     Called to notify client of protocol error conditions
  988.      */
  989.     STDMETHOD(HandleProtocolError) (THIS_
  990.      HX_RESULT status
  991. ) PURE;
  993.     STDMETHOD(HandleRTTResponse) (THIS_
  994.      HX_RESULT status,
  995. const char* pSessionID,
  996. UINT32 ulSecs,
  997. UINT32 ulUSecs
  998. ) PURE;
  1000.     STDMETHOD(HandleCongestion) (THIS_
  1001. HX_RESULT status,
  1002. const char* pSessionID,
  1003.      INT32 xmitMultiplier,
  1004. INT32 recvMultiplier
  1005. ) PURE;
  1007.     STDMETHOD(HandleStreamDone) (THIS_
  1008. HX_RESULT status,
  1009. UINT16 uStreamNumber
  1010. ) PURE;
  1012.     /* This only indicates that all packets have been received from the
  1013.      * server. We still need to read packets from the transport buffer
  1014.      * StreamDone will indicate when there are no more packets to be
  1015.      * read from Transport buffer
  1016.      */
  1017.     STDMETHOD(HandleSourceDone) (THIS) PURE;
  1019.     STDMETHOD(HandlePrerollChange) (THIS_ 
  1020.  RTSPPrerollTypeEnum prerollType,
  1021.  UINT32 ulPreroll
  1022.                                 ) PURE;
  1023. };
  1025. DECLARE_INTERFACE_(IHXRTSPClientProtocol, IUnknown)
  1026. {
  1027.     /*
  1028.      * IUnknown methods
  1029.      */
  1031.     STDMETHOD(QueryInterface) (THIS_
  1032. REFIID riid,
  1033. void** ppvObj) PURE;
  1035.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  1037.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  1039.     /************************************************************************
  1040.      * Method:
  1041.      *     IHXRTSPClientProtocol::Init
  1042.      * Purpose:
  1043.      *     Initialize an IHXTCPSocket and connect to pAddr:port
  1044.      */
  1045.     STDMETHOD(Init)
  1046.      (THIS_
  1047. IUnknown* pContext,
  1048. const char* pAddr,
  1049. UINT16 port,
  1050. IHXRTSPClientProtocolResponse* pClient,
  1051. UINT32 initializationType,
  1052. IHXValues* pSessionHeaders,
  1053. IHXValues* pInfo,
  1054. BOOL bHTTPCloak,
  1055. UINT16 uCloakPort,
  1056. BOOL bNoReuseConnection
  1057. ) PURE;
  1059.     STDMETHOD(SetBuildVersion) (THIS_
  1060.      const char* pVersionString) PURE;
  1062.     /************************************************************************
  1063.      * Method:
  1064.      *     IHXRTSPClientProtocol::Done
  1065.      * Purpose:
  1066.      *     Close protocol objects
  1067.      */
  1068.     STDMETHOD(Done) (THIS) PURE;
  1070.     /************************************************************************
  1071.      * Method:
  1072.      *     IHXRTSPClientProtocol::SendStreamDescriptionRequest
  1073.      * Purpose:
  1074.      *     Request stream description from URL
  1075.      */
  1076.     STDMETHOD(SendStreamDescriptionRequest)
  1077.      (THIS_
  1078. const char* pURL,
  1079. IHXValues* pRequestHeaders
  1080. ) PURE;
  1082.     STDMETHOD(SendStreamRecordDescriptionRequest)
  1083.      (THIS_
  1084. const char* pURL,
  1085. IHXValues* pFileHeader,
  1086. CHXSimpleList* pStreams,
  1087. IHXValues* pRequestHeaders
  1088. ) PURE;
  1090.     /************************************************************************
  1091.      * Method:
  1092.      *     IHXRTSPClientProtocol::SendTransportRequest
  1093.      * Purpose:
  1094.      *     Request a transport type for data stream from an array of
  1095.      *      available transport types
  1096.      */
  1097.     STDMETHOD(SendSetupRequest)
  1098.     (
  1099. THIS_
  1100. RTSPTransportType* pTransType,
  1101. UINT16 nTransTypes,
  1102. IHXValues* pIHXValuesRequestHeaders
  1103.     ) PURE;
  1105.     STDMETHOD(SendSetParameterRequest) (THIS_
  1106.      UINT32 lParamType,
  1107. const char* pParamName,
  1108. IHXBuffer* pParamValue
  1109. ) PURE;
  1110.     
  1111.     STDMETHOD(SendSetParameterRequest)  (THIS_
  1112.      const char* pParamName,
  1113. const char* pParamValue,
  1114. const char* pMimeType,
  1115. const char* pContent) PURE;
  1117.     STDMETHOD(SendGetParameterRequest) (THIS_
  1118.      UINT32 lParamType,
  1119. const char* pParamName
  1120. ) PURE;
  1122.     /************************************************************************
  1123.      * Method:
  1124.      *     IHXRTSPClientProtocol::SendPlayRequest
  1125.      * Purpose:
  1126.      *     Request start of packet delivery
  1127.      */
  1128.     STDMETHOD(SendPlayRequest) (THIS_
  1129. UINT32 lFrom,
  1130. UINT32 lTo,
  1131. CHXSimpleList* pSubList
  1132.     /* RTSPSubscription */
  1133. ) PURE;
  1135.     STDMETHOD(SendPauseRequest) (THIS) PURE;
  1137.     STDMETHOD(SendResumeRequest) (THIS) PURE;
  1139.     STDMETHOD(SendRecordRequest) (THIS) PURE;
  1140.     
  1141.     /************************************************************************
  1142.      * Method:
  1143.      *     IHXRTSPClientProtocol::SendTeardownRequest
  1144.      * Purpose:
  1145.      *     Request release of connection resources
  1146.      */
  1147.     STDMETHOD(SendTeardownRequest) (THIS) PURE;
  1149.     /************************************************************************
  1150.      * Method:
  1151.      *     IHXRTSPClientProtocol::SendPacket
  1152.      * Purpose:
  1153.      *     Send data packet to server (for RECORD)
  1154.      */
  1155.     STDMETHOD(SendPacket) (THIS_
  1156. BasePacket* pPacket
  1157. ) PURE;
  1159.     /************************************************************************
  1160.      * Method:
  1161.      *     IHXRTSPClientProtocol::SendStreamDone
  1162.      * Purpose:
  1163.      *     Send data end packet to server (for RECORD)
  1164.      */
  1165.     STDMETHOD(SendStreamDone) (THIS_
  1166.      UINT16 streamID
  1167. ) PURE;
  1169.     /************************************************************************
  1170.      * Method:
  1171.      *     IHXRTSPClientProtocol::SendStatistics
  1172.      * Purpose:
  1173.      *     Send cumulative stats from player to server
  1174.      */
  1175.     STDMETHOD(SendPlayerStats) (THIS_
  1176.      const char* pStats
  1177. ) PURE;
  1179.     /************************************************************************
  1180.      * Method:
  1181.      *     IHXRTSPClientProtocol::SendKeepAlive
  1182.      * Purpose:
  1183.      *     Send keep alive request to server
  1184.      */
  1185.     STDMETHOD(SendKeepAlive) (THIS) PURE;
  1187.     /************************************************************************
  1188.      * Method:
  1189.      *     IHXRTSPClientProtocol::GetPacket
  1190.      * Purpose:
  1191.      *     Get data packet from transport layer
  1192.      */
  1193.     STDMETHOD(GetPacket) (THIS_
  1194. UINT16 uStreamNumber,
  1195. REF(IHXPacket*) pPacket
  1196. ) PURE;
  1198.     STDMETHOD(StartPackets) (THIS_
  1199. UINT16 uStreamNumber
  1200. ) PURE;
  1202.     STDMETHOD(StopPackets) (THIS_
  1203. UINT16 uStreamNumber
  1204. ) PURE;
  1206.     STDMETHOD(SetProxy) (THIS_
  1207. const char* pProxyHost,
  1208. UINT16 proxyPort
  1209. ) PURE;
  1211.     STDMETHOD(SetResponse) (THIS_
  1212. IHXRTSPClientProtocolResponse* pResp
  1213. ) PURE;
  1215.     STDMETHOD(InitSockets) (THIS) PURE;
  1217.     STDMETHOD(GetCurrentBuffering) (THIS_
  1218. UINT16     uStreamNumber,
  1219. REF(INT64)  llLowestTimestamp, 
  1220. REF(INT64)  llHighestTimestamp,
  1221. REF(UINT32) ulNumBytes,
  1222. REF(BOOL)   bDone) PURE;
  1224.     STDMETHOD(SeekFlush) (THIS) PURE;
  1226.     STDMETHOD_(BOOL, IsDataReceived) (THIS) PURE;
  1228.     STDMETHOD_(BOOL,IsSourceDone) (THIS) PURE;
  1230.     /*
  1231.      * XXX...The following 3 functions had better be removed under
  1232.      *       full IRMA
  1233.      */
  1235.     STDMETHOD_(IHXPendingStatus*, GetPendingStatus) (THIS) PURE;
  1236.     STDMETHOD_(IHXStatistics*, GetStatistics) (THIS) PURE;
  1237.     STDMETHOD_(BOOL, HttpOnly) (THIS) PURE;
  1238.     
  1239.     /*****************************************
  1240.      * Methods specific to TNG/ASM transport
  1241.      *
  1242.      */
  1244.     STDMETHOD(Subscribe) (THIS_
  1245.      CHXSimpleList* pSubscriptions
  1246.     /* RTSPSubscription */
  1247. ) PURE;
  1249.     STDMETHOD(Unsubscribe) (THIS_
  1250.      CHXSimpleList* pUnsubscriptions
  1251.     /* RTSPSubscription */
  1252. ) PURE;
  1254.     STDMETHOD(RuleChange) (THIS_
  1255.      CHXSimpleList* pChanges) PURE;
  1257.     STDMETHOD(BackChannelPacketReady)   (THIS_
  1258.                                         IHXPacket* pPacket) PURE;
  1260.     STDMETHOD(SendRTTRequest) (THIS) PURE;
  1262.     STDMETHOD(SendBWReport) (THIS_
  1263.      INT32 aveBandwidth,
  1264. INT32 packetLoss,
  1265. INT32 bandwidthWanted
  1266. ) PURE;
  1268.     STDMETHOD(SetFirstSeqNum) (THIS_
  1269. UINT16 uStreamNumber,
  1270. UINT16 uSeqNum
  1271. ) PURE;
  1273.     STDMETHOD(SetRTPInfo) (THIS_
  1274. UINT16 uStreamNumber,
  1275. UINT16 uSeqNum,
  1276. UINT32 ulRTPTime,
  1277. RTPInfoEnum info
  1278. ) PURE;
  1280.     STDMETHOD(SetConnectionTimeout) (THIS_
  1281. UINT32 uSeconds
  1282. ) PURE;
  1284.     /* This is a quick fix to correctly display UDPMode in the client.
  1285.      * We currently always show Multicast since the rtsp library
  1286.      * never tells the reponse object that the protocol that actually
  1287.      * succeeded is UDP and not Mutlicast.
  1288.      *
  1289.      * This is an interim soluton. 
  1290.      * Correct solution is to add transport type in HandleSetupResponse(). 
  1291.      * Will do after B2 since I do not break any builds - XXXRA
  1292.      *
  1293.      * MULTICAST_MODE = 1,
  1294.      * UDP_MODE = 2,
  1295.      * TCP_MODE = 3,
  1296.      * 
  1297.      */
  1298.     STDMETHOD_(UINT16, GetProtocolType) (THIS) PURE;
  1300.     STDMETHOD(InitPacketFilter) (THIS_
  1301.  RawPacketFilter* pFilter) PURE;
  1302. };
  1304. DECLARE_INTERFACE_(IHXRTSPTransportResponse, IUnknown)
  1305. {
  1306.     /*
  1307.      * IUnknown methods
  1308.      */
  1310.     STDMETHOD(QueryInterface) (THIS_
  1311. REFIID riid,
  1312. void** ppvObj) PURE;
  1314.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  1316.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  1318.     /*
  1319.      * PacketReady() is for control packets only. Data packets should
  1320.      * be retrieved with the getPacket() call exported by RTSPTransport
  1321.      */
  1323.     STDMETHOD(PacketReady) (THIS_
  1324. HX_RESULT status,
  1325. const char* pSessionID,
  1326. IHXPacket* pPacket
  1327. ) PURE;
  1329.     STDMETHOD(OnRTTRequest) (THIS_
  1330.      HX_RESULT status,
  1331. const char* pSessionID
  1332. ) PURE;
  1334.     STDMETHOD(OnRTTResponse) (THIS_
  1335.      HX_RESULT status,
  1336. const char* pSessionID,
  1337. UINT32 ulSecs,
  1338. UINT32 ulUSecs
  1339. ) PURE;
  1341.     STDMETHOD(OnBWReport) (THIS_
  1342.      HX_RESULT status,
  1343. const char* pSessionID,
  1344. INT32 aveBandwidth,
  1345. INT32 packetLoss,
  1346. INT32 bandwidthWanted
  1347. ) PURE;
  1349.     STDMETHOD(OnCongestion) (THIS_
  1350.      HX_RESULT status,
  1351. const char* pSessionID,
  1352. INT32 xmitMultiplier,
  1353. INT32 recvMultiplier
  1354. ) PURE;
  1356.     STDMETHOD(OnStreamDone) (THIS_
  1357. HX_RESULT status,
  1358. UINT16 uStreamNumber
  1359. ) PURE;
  1361.     STDMETHOD(OnSourceDone) (THIS) PURE;
  1363.     STDMETHOD(OnACK) (THIS_
  1364. HX_RESULT status,
  1365. RTSPResendBuffer* pResendBuffer,
  1366. UINT16 uStreamNumber,
  1367. const char* pSessionID,
  1368. UINT16* pAckList,
  1369. UINT32 uAckListCount,
  1370. UINT16* pNakList,
  1371. UINT32 uNakListCount
  1372. ) PURE;
  1374.     STDMETHOD(OnProtocolError) (THIS_
  1375.      HX_RESULT status
  1376. ) PURE;
  1377. };
  1379. DECLARE_INTERFACE_(IHXRTSPServerTransportResponse, IHXRTSPTransportResponse)
  1380. {
  1381.     STDMETHOD(OnRTTRequest) (THIS_
  1382.      HX_RESULT status,
  1383. const char* pSessionID
  1384. ) PURE;
  1386.     STDMETHOD(OnRTTResponse) (THIS_
  1387.      HX_RESULT status,
  1388. const char* pSessionID,
  1389. UINT32 ulSecs,
  1390. UINT32 ulUSecs
  1391. ) PURE;
  1393.     STDMETHOD(OnBWReport) (THIS_
  1394.      HX_RESULT status,
  1395. const char* pSessionID,
  1396. INT32 aveBandwidth,
  1397. INT32 packetLoss,
  1398. INT32 bandwidthWanted
  1399. ) PURE;
  1401.     STDMETHOD(OnCongestion) (THIS_
  1402.      HX_RESULT status,
  1403. const char* pSessionID,
  1404. INT32 xmitMultiplier,
  1405. INT32 recvMultiplier
  1406. ) PURE;
  1408.     STDMETHOD(OnStreamDone) (THIS_
  1409. HX_RESULT status,
  1410. UINT16 uStreamNumber
  1411. ) PURE;
  1413.     STDMETHOD(OnSourceDone) (THIS) PURE;
  1415.     STDMETHOD(OnACK) (THIS_
  1416. HX_RESULT status,
  1417. RTSPResendBuffer* pResendBuffer,
  1418. UINT16 uStreamNumber,
  1419. const char* pSessionID,
  1420. UINT16* pAckList,
  1421. UINT32 uAckListCount,
  1422. UINT16* pNakList,
  1423. UINT32 uNakListCount
  1424. ) PURE;
  1426.     STDMETHOD(OnProtocolError) (THIS_
  1427.      HX_RESULT status
  1428. ) PURE;
  1429. };
  1431. DECLARE_INTERFACE_(IHXRTSPClientTransportResponse, IHXRTSPTransportResponse)
  1432. {
  1433.     STDMETHOD(OnRTTRequest) (THIS_
  1434.      HX_RESULT status,
  1435. const char* pSessionID
  1436. ) PURE;
  1438.     STDMETHOD(OnRTTResponse) (THIS_
  1439.      HX_RESULT status,
  1440. const char* pSessionID,
  1441. UINT32 ulSecs,
  1442. UINT32 ulUSecs
  1443. ) PURE;
  1445.     STDMETHOD(OnBWReport) (THIS_
  1446.      HX_RESULT status,
  1447. const char* pSessionID,
  1448. INT32 aveBandwidth,
  1449. INT32 packetLoss,
  1450. INT32 bandwidthWanted
  1451. ) PURE;
  1453.     STDMETHOD(OnCongestion) (THIS_
  1454.      HX_RESULT status,
  1455. const char* pSessionID,
  1456. INT32 xmitMultiplier,
  1457. INT32 recvMultiplier
  1458. ) PURE;
  1460.     STDMETHOD(OnStreamDone) (THIS_
  1461. HX_RESULT status,
  1462. UINT16 uStreamNumber
  1463. ) PURE;
  1465.     /* This only indicates that all packets have been received from the
  1466.      * server. We still need to read packets from the transport buffer
  1467.      * StreamDone will indicate when there are no more packets to be
  1468.      * read from Transport buffer
  1469.      */
  1470.     STDMETHOD(OnSourceDone) (THIS) PURE;
  1472.     STDMETHOD(OnACK) (THIS_
  1473. HX_RESULT status,
  1474. RTSPResendBuffer* pResendBuffer,
  1475. UINT16 uStreamNumber,
  1476. const char* pSessionID,
  1477. UINT16* pAckList,
  1478. UINT32 uAckListCount,
  1479. UINT16* pNakList,
  1480. UINT32 uNakListCount
  1481. ) PURE;
  1483.     STDMETHOD(OnProtocolError) (THIS_
  1484.      HX_RESULT status
  1485. ) PURE;
  1486. };
  1488. DEFINE_GUID(IID_IHXPacketResend,     0x00000400, 0xb4c8, 0x11d0, 0x99, 0x95, 0x0, 0xa0, 0x24, 0x8d, 0xa5, 0xf0);
  1490. DECLARE_INTERFACE_(IHXPacketResend, IUnknown)
  1491. {
  1492.     /*
  1493.      * IUnknown methods
  1494.      */
  1496.     STDMETHOD(QueryInterface) (THIS_
  1497. REFIID riid,
  1498. void** ppvObj) PURE;
  1500.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  1502.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  1504.     STDMETHOD(OnPacket) (THIS_
  1505. UINT16 uStreamNumber,
  1506. BasePacket** ppPacket) PURE;
  1507. };
  1509. DEFINE_GUID(IID_IHXRTSPContext,     0x00000401, 0xb4c8, 0x11d0, 0x99, 0x95, 0x0, 0xa0, 0x24, 0x8d, 0xa5, 0xf0);
  1511. DECLARE_INTERFACE_(IHXRTSPContext, IUnknown)
  1512. {
  1513.     /*
  1514.      * IUnknown methods
  1515.      */
  1517.     STDMETHOD(QueryInterface) (THIS_
  1518. REFIID riid,
  1519. void** ppvObj) PURE;
  1521.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  1523.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  1525.     STDMETHOD(GetCurrentSequenceNumber)
  1526.     (
  1527. THIS_
  1528. REF(UINT32) ulSequenceNumber
  1529.     ) PURE;
  1531.     STDMETHOD(GetSessionID)
  1532.     (
  1533. THIS_
  1534. REF(IHXBuffer*) pIHXBufferSessionID
  1535.     ) PURE;
  1536. };
  1538. DEFINE_GUID(IID_IHXTimeStampSync,     0x00000402, 0xb4c8, 0x11d0, 0x99, 0x95, 0x0, 0xa0, 0x24, 0x8d, 0xa5, 0xf0);
  1540. DECLARE_INTERFACE_(IHXTimeStampSync, IUnknown)
  1541. {
  1542.     /*
  1543.      * IUnknown methods
  1544.      */
  1546.     STDMETHOD(QueryInterface) (THIS_
  1547. REFIID riid,
  1548. void** ppvObj) PURE;
  1549.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  1550.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  1552.     STDMETHOD(SetInitialTS(const char* pSessionID, UINT32 ulInitialTS)) PURE;
  1553.     STDMETHOD_(BOOL, NeedInitialTS(const char* pSessionID)) PURE;
  1554.     STDMETHOD_(UINT32, GetInitialTS(const char* pSessionID)) PURE;
  1555.     STDMETHOD(ClearInitialTS(const char* pSessionID)) PURE;
  1556. };
  1559. DEFINE_GUID(IID_IHXTransportSyncServer, 0x16b420d0, 0xf4d0, 0x11d5, 0xaa, 
  1560.     0xc0, 0x0, 0x1, 0x2, 0x51, 0xb3, 0x40);
  1562. DECLARE_INTERFACE_(IHXTransportSyncServer, IUnknown)
  1563. {
  1564.     /*
  1565.      * IUnknown methods
  1566.      */
  1568.     STDMETHOD(QueryInterface) (THIS_
  1569. REFIID riid,
  1570. void** ppvObj) PURE;
  1571.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  1572.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  1574.     STDMETHOD(DistributeSyncAnchor) (THIS_
  1575.     ULONG32 ulHXTime, 
  1576.     ULONG32 ulNTPTime) PURE;
  1578.     STDMETHOD(DistributeSync)     (ULONG32 ulHXTime, 
  1579.     LONG32 lHXTimeOffset) PURE;
  1581.     STDMETHOD(DistributeStartTime)  (ULONG32 ulHXRefTime) PURE;
  1582. };
  1584. DECLARE_INTERFACE_(IHXRTSPServerPauseResponse, IUnknown)
  1585. {
  1586.     /*
  1587.      * IUnknown methods
  1588.      */
  1590.     STDMETHOD(QueryInterface) (THIS_ REFIID riid, void** ppvObj) PURE;
  1591.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  1592.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  1593.     
  1594.     STDMETHOD(HandlePauseRequest) (THIS_ const char* pSessionID, 
  1595.                                            UINT32 ulPausePoint) PURE;
  1596. };
  1598. #endif /* _RTSPIF_H_ */