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

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 _HXCLSNK_H_
  36. #define _HXCLSNK_H_
  37. /*
  38.  * Forward declarations of some interfaces defined or used here-in.
  39.  */
  40. typedef _INTERFACE   IHXClientAdviseSink       IHXClientAdviseSink;
  41. typedef _INTERFACE   IHXRequest IHXRequest;
  42. /****************************************************************************
  43.  * 
  44.  *  Interface:
  45.  * 
  46.  * IHXClientAdviseSink
  47.  * 
  48.  *  Purpose:
  49.  * 
  50.  * Interface supplied by client to core to receive notifications of
  51.  * status changes.
  52.  * 
  53.  *  IID_IHXClientAdviseSink:
  54.  * 
  55.  * {00000B00-0901-11d1-8B06-00A024406D59}
  56.  * 
  57.  */
  58. DEFINE_GUID(IID_IHXClientAdviseSink, 0x00000B00, 0x901, 0x11d1, 0x8b, 0x6, 0x0, 
  59. 0xa0, 0x24, 0x40, 0x6d, 0x59);
  60. #undef  INTERFACE
  61. #define INTERFACE   IHXClientAdviseSink
  62. DECLARE_INTERFACE_(IHXClientAdviseSink, IUnknown)
  63. {
  64.     /*
  65.      * IUnknown methods
  66.      */
  67.     STDMETHOD(QueryInterface) (THIS_
  68. REFIID riid,
  69. void** ppvObj) PURE;
  70.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  71.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  72.     /*
  73.      * IHXClientAdviseSink methods
  74.      */
  75.     /************************************************************************
  76.      * Method:
  77.      *     IHXClientAdviseSink::OnPosLength
  78.      * Purpose:
  79.      *     Called to advise the client that the position or length of the
  80.      *     current playback context has changed.
  81.      */
  82.     STDMETHOD(OnPosLength) (THIS_
  83. UINT32   ulPosition,
  84. UINT32   ulLength) PURE;
  85.     /************************************************************************
  86.      * Method:
  87.      *     IHXClientAdviseSink::OnPresentationOpened
  88.      * Purpose:
  89.      *     Called to advise the client a presentation has been opened.
  90.      */
  91.     STDMETHOD(OnPresentationOpened) (THIS) PURE;
  92.     /************************************************************************
  93.      * Method:
  94.      *     IHXClientAdviseSink::OnPresentationClosed
  95.      * Purpose:
  96.      *     Called to advise the client a presentation has been closed.
  97.      */
  98.     STDMETHOD(OnPresentationClosed) (THIS) PURE;
  99.     /************************************************************************
  100.      * Method:
  101.      *     IHXClientAdviseSink::OnStatisticsChanged
  102.      * Purpose:
  103.      *     Called to advise the client that the presentation statistics
  104.      *     have changed. 
  105.      */
  106.     STDMETHOD(OnStatisticsChanged) (THIS) PURE;
  107.     /************************************************************************
  108.      * Method:
  109.      *     IHXClientAdviseSink::OnPreSeek
  110.      * Purpose:
  111.      *     Called by client engine to inform the client that a seek is
  112.      *     about to occur. The render is informed the last time for the 
  113.      *     stream's time line before the seek, as well as the first new
  114.      *     time for the stream's time line after the seek will be completed.
  115.      *
  116.      */
  117.     STDMETHOD(OnPreSeek) (THIS_
  118. ULONG32     ulOldTime,
  119. ULONG32     ulNewTime) PURE;
  120.     /************************************************************************
  121.      * Method:
  122.      *     IHXClientAdviseSink::OnPostSeek
  123.      * Purpose:
  124.      *     Called by client engine to inform the client that a seek has
  125.      *     just occurred. The render is informed the last time for the 
  126.      *     stream's time line before the seek, as well as the first new
  127.      *     time for the stream's time line after the seek.
  128.      *
  129.      */
  130.     STDMETHOD(OnPostSeek) (THIS_
  131. ULONG32     ulOldTime,
  132. ULONG32     ulNewTime) PURE;
  133.     /************************************************************************
  134.      * Method:
  135.      *     IHXClientAdviseSink::OnStop
  136.      * Purpose:
  137.      *     Called by client engine to inform the client that a stop has
  138.      *     just occurred. 
  139.      *
  140.      */
  141.     STDMETHOD(OnStop) (THIS) PURE;
  142.     /************************************************************************
  143.      * Method:
  144.      *     IHXClientAdviseSink::OnPause
  145.      * Purpose:
  146.      *     Called by client engine to inform the client that a pause has
  147.      *     just occurred. The render is informed the last time for the 
  148.      *     stream's time line before the pause.
  149.      *
  150.      */
  151.     STDMETHOD(OnPause) (THIS_
  152. ULONG32     ulTime) PURE;
  153.     /************************************************************************
  154.      * Method:
  155.      *     IHXClientAdviseSink::OnBegin
  156.      * Purpose:
  157.      *     Called by client engine to inform the client that a begin or
  158.      *     resume has just occurred. The render is informed the first time 
  159.      *     for the stream's time line after the resume.
  160.      *
  161.      */
  162.     STDMETHOD(OnBegin) (THIS_
  163. ULONG32     ulTime) PURE;
  164.     /************************************************************************
  165.      * Method:
  166.      *     IHXClientAdviseSink::OnBuffering
  167.      * Purpose:
  168.      *     Called by client engine to inform the client that buffering
  169.      *     of data is occuring. The render is informed of the reason for
  170.      *     the buffering (start-up of stream, seek has occurred, network
  171.      *     congestion, etc.), as well as percentage complete of the 
  172.      *     buffering process.
  173.      *
  174.      */
  175.     STDMETHOD(OnBuffering) (THIS_
  176. ULONG32     ulFlags,
  177. UINT16     unPercentComplete) PURE;
  178.     /************************************************************************
  179.      * Method:
  180.      *     IHXClientAdviseSink::OnContacting
  181.      * Purpose:
  182.      *     Called by client engine to inform the client is contacting
  183.      *     hosts(s).
  184.      *
  185.      */
  186.     STDMETHOD(OnContacting) (THIS_
  187.  const char* pHostName) PURE;
  188. };
  189. // $Private:
  190. /****************************************************************************
  191.  * 
  192.  *  Interface:
  193.  *
  194.  * IHXClientRequestSink
  195.  *
  196.  *  Purpose:
  197.  *
  198.  * Enables top level clients to get notified of new URLs
  199.  *
  200.  *
  201.  *      IID_IHXClientRequestSink
  202.  *
  203.  * {00000B01-0901-11d1-8B06-00A024406D59}
  204.  * 
  205.  */
  206. DEFINE_GUID(IID_IHXClientRequestSink, 0x00000B01, 0x901, 0x11d1, 0x8b, 0x6, 0x0, 
  207. 0xa0, 0x24, 0x40, 0x6d, 0x59);
  208. #undef  INTERFACE
  209. #define INTERFACE   IHXClientRequestSink
  210. DECLARE_INTERFACE_(IHXClientRequestSink, IUnknown)
  211. {
  212.     /************************************************************************
  213.      * Method:
  214.      *     IHXClientRequestSink::OnNewRequest
  215.      * Purpose:
  216.      *     Inform TLC of the new request. The TLC may choose to 
  217.      *     modify RequestHeaders at this time.
  218.      */
  219.     STDMETHOD(OnNewRequest)  (THIS_ IHXRequest* pNewRequest) PURE;
  220. };
  221. // $EndPrivate.
  222. #endif /* _HXCLSNK_H_ */