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

源码开发语言/平台
当前位置：首页 > 源码/资料 > 通讯/手机编程 > Symbian > 查看源码
rtspif.h
资源名称：helix.src.0812.rar　[点击查看]
上传用户：zhongxx05
上传日期：2007-06-06
资源大小：33641k
文件大小：43k
源码类别：

Symbian

开发平台：

C/C++

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