hxsdesc.h
上传用户:zhongxx05
上传日期:2007-06-06
资源大小:33641k
文件大小:7k
源码类别:

Symbian

开发平台:

C/C++

  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 ***** */ 
  35. #ifndef _HXSDESC_
  36. #define _HXSDESC_
  37. /*
  38.  * Forward declarations of some interfaces defined or used here-in.
  39.  */
  40. typedef _INTERFACE IUnknown IUnknown;
  41. struct IHXBuffer;
  42. struct IHXValues;
  43. /****************************************************************************
  44.  * 
  45.  *  Interface:
  46.  *
  47.  * IHXStreamDescription
  48.  *
  49.  *  Purpose:
  50.  *
  51.  * This interface allows transforms between IHXValues and stream
  52.  * description formats.
  53.  *
  54.  *
  55.  *  IID_IHXStreamDescription:
  56.  *
  57.  * {00001900-0901-11d1-8B06-00A024406D59}
  58.  *
  59.  */
  60. DEFINE_GUID(IID_IHXStreamDescription, 0x00001900, 0x901, 0x11d1, 0x8b, 0x6, 0x0, 
  61. 0xa0, 0x24, 0x40, 0x6d, 0x59); 
  62. #undef  INTERFACE
  63. #define INTERFACE   IHXStreamDescription
  64. DECLARE_INTERFACE_(IHXStreamDescription, IUnknown)
  65. {
  66.     /*
  67.      * IUnknown methods
  68.      */
  69.     STDMETHOD(QueryInterface) (THIS_
  70. REFIID riid,
  71. void** ppvObj) PURE;
  72.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  73.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  74.     /*
  75.      * IHXStreamDescription methods
  76.      */
  77.     /************************************************************************
  78.      * Method:
  79.      *     IHXStreamDescription::GetStreamDescriptionInfo
  80.      * Purpose:
  81.      *     Get info to initialize the stream description plugin
  82.      */
  83.     STDMETHOD(GetStreamDescriptionInfo)
  84. (THIS_
  85. REF(const char*) /*OUT*/ pMimeTypes) PURE;
  86.     /************************************************************************
  87.      * Method:
  88.      *     IHXStreamDescription::GetValues
  89.      * Purpose:
  90.      *     Transform a media description string into an IHXValues
  91.      * object.
  92.      */
  93.     STDMETHOD(GetValues) (THIS_
  94.      IHXBuffer*      /*IN*/  pDescription,
  95. REF(UINT16)     /*OUT*/ nValues,
  96.      REF(IHXValues**)   /*OUT*/ pValueArray) PURE;
  97.     /************************************************************************
  98.      * Method:
  99.      *     IHXStreamDescription::GetDescription
  100.      * Purpose:
  101.      *     Transform an IHXValues object into a stream description
  102.      * string.
  103.      */
  104.     STDMETHOD(GetDescription) (THIS_
  105. UINT16     /*IN*/   nValues,
  106. IHXValues**     /*IN*/   pValueArray,
  107.      REF(IHXBuffer*)    /*OUT*/  pDescription) PURE;
  108. };
  109. /****************************************************************************
  110.  * 
  111.  *  Interface:
  112.  *
  113.  * IHXRTPPayloadInfo
  114.  *
  115.  *  Purpose:
  116.  *
  117.  * This interface exposes the conversion table used to convert RTP
  118.  *      timestamps to RMA timestamps and whether or not the content is
  119.  *      timestamp deliverable.
  120.  *
  121.  *
  122.  *  IID_IHXRTPPayloadInfo:
  123.  *
  124.  * {00001901-0901-11d1-8B06-00A024406D59}
  125.  *
  126.  */
  127. DEFINE_GUID(IID_IHXRTPPayloadInfo, 0x00001901, 0x901, 0x11d1, 0x8b, 0x6, 0x0, 
  128. 0xa0, 0x24, 0x40, 0x6d, 0x59); 
  129. #undef  INTERFACE
  130. #define INTERFACE   IHXRTPPayloadInfo
  131. DECLARE_INTERFACE_(IHXRTPPayloadInfo, IUnknown)
  132. {
  133.     /*
  134.      * IUnknown methods
  135.      */
  136.     STDMETHOD(QueryInterface) (THIS_
  137. REFIID riid,
  138. void** ppvObj) PURE;
  139.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  140.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  141.     /*
  142.      * IHXRTPPayloadInfo methods
  143.      */
  144.     /************************************************************************
  145.      * Method:
  146.      *     IHXRTPPayloadInfo::PayloadSupported
  147.      * Purpose:
  148.      *     Returns TRUE if this payload type is handled by this interface
  149.      */
  150.     STDMETHOD_(BOOL, IsPayloadSupported)     (THIS_
  151. UINT32      /*IN*/  ulRTPPayloadType) PURE;
  152.     /************************************************************************
  153.      * Method:
  154.      *     IHXRTPPayloadInfo::GetTimestampConversionFactors
  155.      * Purpose:
  156.      *     Retrieves the RTP and RMA factors for RTP to RMA timestamp ratio.
  157.      *      RTP->RMA is RTPTimestamp * HXFactor / RTPFactor
  158.      *      RMA->RTP is HXTimestamp * RTPFactor / HXFactor
  159.      *  
  160.      *  Note: 
  161.      *      Does not check if the payload type is supported
  162.      */
  163.     STDMETHOD(GetTimestampConversionFactors)     (THIS_
  164.      UINT32      /*IN*/  ulRTPPayloadType,
  165. REF(UINT32) /*OUT*/ ulRTPFactor,
  166. REF(UINT32) /*OUT*/ ulHXFactor) PURE;
  167.     /************************************************************************
  168.      * Method:
  169.      *     IHXRTPPayloadInfo::IsTimestampDeliverable
  170.      * Purpose:
  171.      *     Returns TRUE if this payload type is timestamp deliverable
  172.      */
  173.     STDMETHOD_(BOOL, IsTimestampDeliverable)     (THIS_
  174. UINT32      /*IN*/  ulRTPPayloadType) PURE;
  175. };
  176. /****************************************************************************
  177.  * 
  178.  *  Interface:
  179.  *
  180.  * IHXStreamDescriptionSettings
  181.  *
  182.  *  Purpose:
  183.  *
  184.  * Manage settings related to stream description
  185.  *
  186.  *
  187.  *  IID_IHXStreamDescriptionOptions:
  188.  *
  189.  * {00001902-0901-11d1-8B06-00A024406D59}
  190.  *
  191.  */
  192. DEFINE_GUID(IID_IHXStreamDescriptionSettings, 0x00001902, 0x901, 0x11d1, 0x8b, 0x6, 0x0, 
  193. 0xa0, 0x24, 0x40, 0x6d, 0x59); 
  194. #undef  INTERFACE
  195. #define INTERFACE   IHXStreamDescriptionSettings
  196. DECLARE_INTERFACE_(IHXStreamDescriptionSettings, IUnknown)
  197. {
  198.     /*
  199.      * IUnknown methods
  200.      */
  201.     STDMETHOD(QueryInterface) (THIS_ REFIID riid, void** ppvObj) PURE;
  202.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  203.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  204.     /*
  205.      * IHXStreamDescriptionSettings methods
  206.      */
  207.     STDMETHOD(SetOption)(const char* pKey, IHXBuffer* pVal) PURE;
  208.     STDMETHOD(GetOption)(const char* pKey, REF(IHXBuffer*) pVal) PURE;
  209. };
  210. #endif /* _HXSDESC_ */