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

Symbian

开发平台:

C/C++

  1. /* ***** BEGIN LICENSE BLOCK *****  
  2.  * Source last modified: $Id: hxqos.h,v 1.5 2003/09/05 18:30:21 jc Exp $ 
  3.  *   
  4.  * Portions Copyright (c) 1995-2003 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.  * This file is part of the Helix DNA Technology. RealNetworks is the 
  21.  * developer of the Original Code and owns the copyrights in the 
  22.  * portions it created. 
  23.  *   
  24.  * This file, and the files included with this file, is distributed 
  25.  * and made available on an 'AS IS' basis, WITHOUT WARRANTY OF ANY 
  26.  * KIND, EITHER EXPRESS OR IMPLIED, AND REALNETWORKS HEREBY DISCLAIMS 
  27.  * ALL SUCH WARRANTIES, INCLUDING WITHOUT LIMITATION, ANY WARRANTIES 
  28.  * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, QUIET 
  29.  * ENJOYMENT OR NON-INFRINGEMENT. 
  30.  *  
  31.  * Technology Compatibility Kit Test Suite(s) Location:  
  32.  *    http://www.helixcommunity.org/content/tck  
  33.  *  
  34.  * Contributor(s):  
  35.  *   
  36.  * ***** END LICENSE BLOCK ***** */  
  37. #ifndef _HX_QOS_H_
  38. #define _HX_QOS_H_
  39. /* Foreward Declaration of Interfaces */
  40. typedef _INTERFACE IHXBuffer      IHXBuffer;
  41. typedef _INTERFACE IHXSetSocketOption        IHXSetSocketOption;
  42. typedef _INTERFACE IHXQoSSignalBusController IHXQoSSignalBusController;
  43. typedef _INTERFACE IHXQoSSignalSource        IHXQoSSignalSource;
  44. typedef _INTERFACE IHXQoSSignalSink          IHXQoSSignalSink;
  45. typedef _INTERFACE IHXQoSSignalBus           IHXQoSSignalBus;
  46. typedef _INTERFACE IHXQoSSignalFilterTool    IHXQoSSignalFilterTool;
  47. typedef _INTERFACE IHXQoSSignal              IHXQoSSignal;
  48. typedef _INTERFACE IHXQoSDiffServConfigurator IHXQoSDiffServConfigurator;
  49. typedef UINT16 HX_QOS_SIGNAL;   
  50. typedef enum _HX_QOS_DIFFSERV_CLASS
  51. {
  52.     HX_QOS_DIFFSERV_CLASS_MEDIA,
  53.     HX_QOS_DIFFSERV_CLASS_CONTROL,
  54.     HX_QOS_DIFFSERV_CLASS_ADMIN,
  55.     HX_QOS_DIFFSERV_CLASS_DIST,
  56.     HX_QOS_DIFFSERV_CLASS_COUNT
  57. } HX_QOS_DIFFSERV_CLASS;
  58. /*
  59.  * IHXQoSProfileSelector
  60.  * {75DB043B-C5A8-49b2-8D3F-8CF99F9E6444}
  61.  */
  62. DEFINE_GUID(IID_IHXQoSProfileSelector, 
  63.     0x75db043b, 0xc5a8, 0x49b2, 0x8d, 0x3f, 0x8c, 0xf9, 0x9f, 0x9e, 0x64, 0x44);
  64. #undef  INTERFACE
  65. #define INTERFACE   IHXQoSProfileSelector 
  66. DECLARE_INTERFACE_(IHXQoSProfileSelector, IUnknown)
  67. {
  68.     // IUnknown
  69.     STDMETHOD(QueryInterface)   ( THIS_ REFIID riid, void** ppvObj ) PURE;
  70.     STDMETHOD_(ULONG32,AddRef)  ( THIS ) PURE;
  71.     STDMETHOD_(ULONG32,Release) ( THIS ) PURE;
  72.     // IHXQoSProfileSelector
  73.     STDMETHOD (SelectProfile)   (THIS_ IHXBuffer* pUserAgent,
  74.  IHXBuffer* pTransportMime,
  75.  IHXBuffer* pMediaMime,
  76.  REF(INT32) /*OUT*/ ulConfigID) PURE;
  77. };
  78. /*
  79.  * IHXQoSProfileConfigurator
  80.  * {75DB043B-C5A8-49b2-8D3F-8CF99F9E6448}
  81.  */
  82. DEFINE_GUID(IID_IHXQoSProfileConfigurator,
  83.     0x75db043b, 0xc5a8, 0x49b2, 0x8d, 0x3f, 0x8c, 0xf9, 0x9f, 0x9e, 0x64, 0x48);
  84. #undef  INTERFACE
  85. #define INTERFACE   IHXQoSProfileConfigurator
  86. DECLARE_INTERFACE_(IHXQoSProfileConfigurator, IUnknown)
  87. {
  88.     // IUnknown
  89.     STDMETHOD(QueryInterface)   ( THIS_ REFIID riid, void** ppvObj ) PURE;
  90.     STDMETHOD_(ULONG32,AddRef)  ( THIS ) PURE;
  91.     STDMETHOD_(ULONG32,Release) ( THIS ) PURE;
  92.     // IHXQoSProfileConfigurator
  93.     STDMETHOD (SetConfigId)         (THIS_ INT32 lConfigId) PURE;
  94.     STDMETHOD (GetConfigId)         (THIS_ REF(INT32) /*OUT*/ lConfigId) PURE;
  95.     STDMETHOD (GetConfigInt)    (THIS_ const char* pName, REF(INT32) /*OUT*/ lValue) PURE; 
  96.     STDMETHOD (GetConfigBuffer) (THIS_ const char* pName, REF(IHXBuffer*) /*OUT*/ pValue) PURE; 
  97. };
  98. /*
  99.  * IHXQoSSignalSourceResponse
  100.  * {B6154B09-BBC3-4239-BE8B-81607CA0BE09}
  101.  */
  102. DEFINE_GUID(IID_IHXQoSSignalSourceResponse, 
  103.     0xb6154b09, 0xbbc3, 0x4239, 0xbe, 0x8b, 0x81, 0x60, 0x7c, 0xa0, 0xbe, 0x9);
  104. #undef  INTERFACE
  105. #define INTERFACE   IHXQoSSignalSourceResponse 
  106. DECLARE_INTERFACE_(IHXQoSSignalSourceResponse, IUnknown)
  107. {
  108.     // IUnknown
  109.     STDMETHOD(QueryInterface)           ( THIS_ REFIID riid, void** ppvObj ) PURE;
  110.     STDMETHOD_(ULONG32,AddRef)          ( THIS ) PURE;
  111.     STDMETHOD_(ULONG32,Release)         ( THIS ) PURE;
  112.     // IHXQoSSignalSourceResponse
  113.     STDMETHOD (SignalBusReady)(THIS_ HX_RESULT hResult, IHXQoSSignalBus* pBus, 
  114.        IHXBuffer* pSessionId) PURE;
  115. };
  116. /*
  117.  * IHXQoSSignalSource
  118.  * {42AEDDAE-3C4A-498c-863E-E6EDEED402A5}
  119.  */
  120. DEFINE_GUID(IID_IHXQoSSignalSource, 
  121.     0x42aeddae, 0x3c4a, 0x498c, 0x86, 0x3e, 0xe6, 0xed, 0xee, 0xd4, 0x2, 0xa5);
  122. #undef  INTERFACE
  123. #define INTERFACE   IHXQoSSignalSource
  124. DECLARE_INTERFACE_(IHXQoSSignalSource, IUnknown)
  125. {
  126.     // IUnknown
  127.     STDMETHOD(QueryInterface)           ( THIS_ REFIID riid, void** ppvObj ) PURE;
  128.     STDMETHOD_(ULONG32,AddRef)          ( THIS ) PURE;
  129.     STDMETHOD_(ULONG32,Release)         ( THIS ) PURE;
  130.     // IHXQoSSignalSource
  131.     STDMETHOD (GetSignalBus) (THIS_ IHXBuffer* pSessionId,
  132.       IHXQoSSignalSourceResponse* pResp) PURE;
  133.     STDMETHOD (ReleaseResponseObject) (THIS_ IHXBuffer* pSessionId,
  134.       IHXQoSSignalSourceResponse* pResp) PURE;
  135. };
  136. /*
  137.  * IHXQoSSignalSink
  138.  * {8B94C9CF-48E2-4384-BC39-701B924F556F}
  139.  */
  140. DEFINE_GUID(IID_IHXQoSSignalSink, 
  141.     0x8b94c9cf, 0x48e2, 0x4384, 0xbc, 0x39, 0x70, 0x1b, 0x92, 0x4f, 0x55, 0x6f);
  142. #undef  INTERFACE
  143. #define INTERFACE   IHXQoSSignalSink
  144. DECLARE_INTERFACE_(IHXQoSSignalSink, IUnknown)
  145. {
  146.     // IUnknown
  147.     STDMETHOD(QueryInterface)           ( THIS_ REFIID riid, void** ppvObj ) PURE;
  148.     STDMETHOD_(ULONG32,AddRef)          ( THIS ) PURE;
  149.     STDMETHOD_(ULONG32,Release)         ( THIS ) PURE;
  150.     // IHXQoSSignalSink
  151.     STDMETHOD (Signal)(THIS_ IHXQoSSignal* pSignal, IHXBuffer* pSessionId) PURE;
  152.     STDMETHOD (ChannelClosed)(THIS_ IHXBuffer* pSessionId) PURE;
  153. };
  154. /*
  155.  * IHXQoSSignalBus
  156.  * {8003507E-453F-4439-BF08-7F8A0E083D9E}
  157.  */
  158. DEFINE_GUID(IID_IHXQoSSignalBus, 
  159.     0x8003507e, 0x453f, 0x4439, 0xbf, 0x8, 0x7f, 0x8a, 0xe, 0x8, 0x3d, 0x9e);
  160. #undef  INTERFACE
  161. #define INTERFACE   IHXQosSignalBus
  162. DECLARE_INTERFACE_(IHXQoSSignalBus, IUnknown)
  163. {
  164.     // IUnknown
  165.     STDMETHOD(QueryInterface)           ( THIS_ REFIID riid, void** ppvObj ) PURE;
  166.     STDMETHOD_(ULONG32,AddRef)          ( THIS ) PURE;
  167.     STDMETHOD_(ULONG32,Release)         ( THIS ) PURE;
  168.     // IHXQoSSignalBus
  169.     STDMETHOD (Init) (THIS_ IHXBuffer* pSessionId) PURE;
  170.     STDMETHOD (Close) (THIS) PURE;
  171.     STDMETHOD (Send) (THIS_ IHXQoSSignal* pSignal) PURE;
  172.     STDMETHOD (AttachListener)  (THIS_ HX_QOS_SIGNAL ulListenFilter, IHXQoSSignalSink* pListener) PURE;
  173.     STDMETHOD (DettachListener) (THIS_ HX_QOS_SIGNAL ulListenFilter, IHXQoSSignalSink* pListener) PURE;
  174. };
  175. /* 
  176.  * IHXQoSignal
  177.  * {32126BDC-0074-4f43-8D2C-65D76D60B5CB}
  178.  */
  179. DEFINE_GUID(IID_IHXQoSSignal, 
  180.     0x32126bdc, 0x74, 0x4f43, 0x8d, 0x2c, 0x65, 0xd7, 0x6d, 0x60, 0xb5, 0xcb);
  181. #undef  INTERFACE
  182. #define INTERFACE   IHXQoSSignal
  183. //A class factory may create this object
  184. #define CLSID_IHXQoSSignal IID_IHXQoSSignal
  185. DECLARE_INTERFACE_(IHXQoSSignal, IUnknown)
  186. {
  187.     // IUnknown
  188.     STDMETHOD(QueryInterface)           (THIS_ REFIID riid, void** ppvObj) PURE;
  189.     STDMETHOD_(ULONG32,AddRef)          (THIS) PURE;
  190.     STDMETHOD_(ULONG32,Release)         (THIS) PURE;
  191.     //IHXQoSSignal
  192.     STDMETHOD (GetId) (THIS_ REF(HX_QOS_SIGNAL) ulSignalId) PURE;
  193.     STDMETHOD (SetId) (THIS_ HX_QOS_SIGNAL ulSignalId) PURE;
  194.     STDMETHOD (GetValueUINT32) (THIS_ REF(UINT32) ulValue) PURE;
  195.     STDMETHOD (SetValueUINT32) (THIS_ UINT32 ulValue) PURE;
  196.     STDMETHOD (GetValue) (THIS_ REF(IHXBuffer*) pBuffer) PURE;
  197.     STDMETHOD (SetValue) (THIS_ IHXBuffer* pBuffer) PURE;
  198.     STDMETHOD (WriteSignal) (THIS_ UINT32 ulFileDescriptor) PURE;
  199. };
  200. /****************************************************************************
  201.  * 
  202.  *  Interface:
  203.  * 
  204.  * IHXQOSClassFactory
  205.  * 
  206.  *  Purpose:
  207.  * 
  208.  * HX interface that manages the creation of HX QoS classes.
  209.  * 
  210.  *  IID_IHXQoSClassFactory:
  211.  * 
  212.  *      {C1316A78-2960-4f5c-A2A9-46D9C925E88F}
  213.  * 
  214.  */
  215. DEFINE_GUID(IID_IHXQoSClassFactory, 
  216.             0xc1316a78, 0x2960, 0x4f5c, 0xa2, 0xa9, 0x46, 0xd9, 0xc9, 0x25, 0xe8, 0x8f);
  217. #undef  INTERFACE
  218. #define INTERFACE   IHXQoSClassFactory
  219. DECLARE_INTERFACE_(IHXQoSClassFactory, IUnknown)
  220. {
  221.     /*
  222.      * IUnknown methods
  223.      */
  224.     STDMETHOD(QueryInterface) (THIS_
  225. REFIID riid,
  226. void** ppvObj) PURE;
  227.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  228.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  229.     /*
  230.      * IHXQOSClassFactory methods
  231.      */
  232.     /************************************************************************
  233.      * Method:
  234.      *     IHXCommonClassFactory::CreateInstance
  235.      * Purpose:
  236.      *     Creates instances of QoS classes. The first argument is the 
  237.      *      profile for which you are creating the objects.
  238.      */
  239.     STDMETHOD(CreateInstance) (THIS_
  240.  IHXQoSProfileConfigurator* pConfig,
  241.  REFCLSID    /*IN*/  rclsid,
  242.  void**     /*OUT*/ ppUnknown) PURE; 
  243. };
  244. /*
  245.  * IHXQoSDiffServConfigurator
  246.  * {5FB79E3A-9BEF-4676-8977-08FF6B2D7270}
  247.  */
  248. DEFINE_GUID(IID_IHXQoSDiffServConfigurator, 
  249.     0x5fb79e3a, 0x9bef, 0x4676, 0x89, 0x77, 0x8, 0xff, 0x6b, 0x2d, 0x72, 0x70);
  250. #undef  INTERFACE
  251. #define INTERFACE  IHXQoSDiffServConfigurator
  252. DECLARE_INTERFACE_(IHXQoSDiffServConfigurator, IUnknown)
  253. {
  254.     // IUnknown
  255.     STDMETHOD(QueryInterface)           ( THIS_ REFIID riid, void** ppvObj ) PURE;
  256.     STDMETHOD_(ULONG32,AddRef)          ( THIS ) PURE;
  257.     STDMETHOD_(ULONG32,Release)         ( THIS ) PURE;
  258.     // IHXQoSDiffServConfigurator
  259.     STDMETHOD(ConfigureSocket) (THIS_ IHXSetSocketOption* pSockOpt, 
  260. HX_QOS_DIFFSERV_CLASS cClass) PURE; 
  261. };
  262. #endif /* _HX_QOS_H_ */