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

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 _IHXOptimizedScheduler_
  36. #define _IHXOptimizedScheduler_
  37. class  ClientPQ;
  38. class  CHXID;
  39. class  HXMutex;
  40. struct IUnknown;
  41. struct IHXScheduler;
  42. typedef struct _HXTimeval HXTimeval;
  43. #include "timeval.h"
  44. class CAsyncTimer;
  45. // HXOptimizedSchedulerBase is a base class that allows the core
  46. // to control the scheduler object without knowing the actual 
  47. // implementation of the object.
  48. class HXOptimizedSchedulerBase : public IHXOptimizedScheduler
  49. {
  50. public:
  51.     /*
  52.      *  IUnknown methods
  53.      */
  54.     STDMETHOD(QueryInterface) (THIS_
  55. REFIID riid,
  56. void** ppvObj) PURE;
  57.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  58.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  59.     /*
  60.      * IHXOptimizedScheduler methods
  61.      */
  62.     /************************************************************************
  63.      * Method:
  64.      *     IHXOptimizedScheduler::RelativeEnter
  65.      * Purpose:
  66.      *     Schedule a callback to be executed "ms" milliseconds from now
  67.      *     This function is less percise then AbsoluteEnter and should only
  68.      *     be used when accurate timing is not critical.
  69.      */
  70.     STDMETHOD_(CallbackHandle,RelativeEnter) (THIS_
  71. IHXCallback* pCallback,
  72. UINT32 ms) PURE;
  73.     /************************************************************************
  74.      * Method:
  75.      *     IHXOptimizedScheduler::AbsoluteEnter
  76.      * Purpose:
  77.      *     Schedule a callback to be executed at time "tVal".
  78.      */
  79.     STDMETHOD_(CallbackHandle,AbsoluteEnter) (THIS_
  80. IHXCallback* pCallback,
  81. HXTimeval tVal) PURE;
  82.     /************************************************************************
  83.      * Method:
  84.      *     IHXOptimizedScheduler::Remove
  85.      * Purpose:
  86.      *     Remove a callback from the scheduler.
  87.      */
  88.     STDMETHOD(Remove) (THIS_
  89.      CallbackHandle Handle) PURE;
  90.     /************************************************************************
  91.      * Method:
  92.      *     IHXOptimizedScheduler::GetCurrentSchedulerTime
  93.      * Purpose:
  94.      *     Gives the current time (in the timeline of the scheduler).
  95.      */
  96.     STDMETHOD_(HXTimeval,GetCurrentSchedulerTime) (THIS) PURE;
  97.     // Scheduler control functions
  98.     virtual HX_RESULT StartScheduler() PURE;
  99.     virtual void StopScheduler() PURE;
  100. };
  101. class HXOptimizedScheduler : public HXOptimizedSchedulerBase
  102. {
  103. public:
  104. HXOptimizedScheduler(IUnknown* pContext);
  105. ~HXOptimizedScheduler();
  106.     /*
  107.      * IUnknown methods
  108.      */
  109.     STDMETHOD(QueryInterface) (THIS_
  110. REFIID riid,
  111. void** ppvObj);
  112.     STDMETHOD_(ULONG32,AddRef) (THIS);
  113.     STDMETHOD_(ULONG32,Release) (THIS);
  114.     /*
  115.      * HXOptimizedScheduler methods
  116.      */
  117.     /************************************************************************
  118.      * Method:
  119.      *     IHXOptimizedScheduler::RelativeEnter
  120.      * Purpose:
  121.      *     enter objects in the service queue offset from time now
  122.      */
  123.     STDMETHOD_(CallbackHandle,RelativeEnter) (THIS_
  124. IHXCallback* pCallback,
  125. UINT32 ms);
  126.     /************************************************************************
  127.      * Method:
  128.      *     IHXOptimizedScheduler::AbsoluteEnter
  129.      * Purpose:
  130.      *     enter objects in the service queue at absolute time
  131.      */
  132.     STDMETHOD_(CallbackHandle,AbsoluteEnter) (THIS_
  133. IHXCallback* pCallback,
  134. HXTimeval tVal);
  135.     /************************************************************************
  136.      * Method:
  137.      *     IHXOptimizedScheduler::Remove
  138.      * Purpose:
  139.      *     remove objects from the service queue
  140.      */
  141.     STDMETHOD(Remove) (THIS_
  142.      CallbackHandle Handle);
  143.     /************************************************************************
  144.      * Method:
  145.      *     IHXOptimizedScheduler::GetCurrentSchedulerTime
  146.      * Purpose:
  147.      *     gives the current time in the timeline of the scheduler...
  148.      */
  149.     STDMETHOD_(HXTimeval,GetCurrentSchedulerTime) (THIS);
  150.     HX_RESULT ExecuteCurrentFunctions();
  151.     HX_RESULT StartScheduler();
  152.     
  153.     void StopScheduler();
  154.     BOOL GetNextEventDueTime(UINT32& ulNumMs);
  155. protected:
  156.     LONG32     m_lRefCount;
  157.     ClientPQ*     m_pPQ;
  158.     CHXID*     m_pID;
  159.     IUnknown*     m_pContext;
  160.     IHXScheduler*  m_pScheduler;
  161.     HXTimeval     m_CurrentTimeVal;
  162.     UINT32     m_ulLastUpdateTime;
  163.     UINT32     m_ulLastSyncTime;
  164.     HXMutex*     m_pMutex;
  165.     /* Used to schedule events in a separate thread */
  166.     friend void* ThreadRoutine (void * pArg);
  167.     inline void UpdateCurrentTime(Timeval* pNow);
  168.     HXThread*     m_pThread;
  169.     HXEvent*     m_pQuitEvent;
  170.     HXEvent*     m_pSleepEvent;
  171.     ULONG32     m_ulCurrentGranularity;
  172.     BOOL     m_bIsDone;
  173. };
  174. #endif // _IHXOptimizedScheduler_