hxthread.h
上传用户:dangjiwu
上传日期:2013-07-19
资源大小:42019k
文件大小:7k
源码类别:

Symbian

开发平台:

Visual C++

  1. /* ***** BEGIN LICENSE BLOCK *****
  2.  * Source last modified: $Id: hxthread.h,v 1.3.2.3 2004/07/09 01:43:51 hubbe Exp $
  3.  * 
  4.  * Portions Copyright (c) 1995-2004 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.  * Alternatively, the contents of this file may be used under the
  21.  * terms of the GNU General Public License Version 2 or later (the
  22.  * "GPL") in which case the provisions of the GPL are applicable
  23.  * instead of those above. If you wish to allow use of your version of
  24.  * this file only under the terms of the GPL, and not to allow others
  25.  * to use your version of this file under the terms of either the RPSL
  26.  * or RCSL, indicate your decision by deleting the provisions above
  27.  * and replace them with the notice and other provisions required by
  28.  * the GPL. If you do not delete the provisions above, a recipient may
  29.  * use your version of this file under the terms of any one of the
  30.  * RPSL, the RCSL or the GPL.
  31.  * 
  32.  * This file is part of the Helix DNA Technology. RealNetworks is the
  33.  * developer of the Original Code and owns the copyrights in the
  34.  * portions it created.
  35.  * 
  36.  * This file, and the files included with this file, is distributed
  37.  * and made available on an 'AS IS' basis, WITHOUT WARRANTY OF ANY
  38.  * KIND, EITHER EXPRESS OR IMPLIED, AND REALNETWORKS HEREBY DISCLAIMS
  39.  * ALL SUCH WARRANTIES, INCLUDING WITHOUT LIMITATION, ANY WARRANTIES
  40.  * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, QUIET
  41.  * ENJOYMENT OR NON-INFRINGEMENT.
  42.  * 
  43.  * Technology Compatibility Kit Test Suite(s) Location:
  44.  *    http://www.helixcommunity.org/content/tck
  45.  * 
  46.  * Contributor(s):
  47.  * 
  48.  * ***** END LICENSE BLOCK ***** */
  49. #ifndef _HXTHREAD_H_
  50. #define _HXTHREAD_H_
  51. #include "hxtypes.h"
  52. #include "hxresult.h"
  53. #define ALLFS 0xFFFFFFFF
  54. #if !defined( _WIN32 ) && !defined( _WINDOWS )
  55. typedef void (*TIMERPROC)( void* , UINT32 , UINT32, ULONG32 );
  56. #endif
  57. #if defined(HELIX_FEATURE_NETWORK_USE_SELECT)
  58. class conn;
  59. #endif //defined(HELIX_FEATURE_NETWORK_USE_SELECT)
  60. struct HXThreadMessage
  61. {
  62.     HXThreadMessage() 
  63. {
  64.     m_ulMessage     = 0; 
  65.     m_pParam1     = NULL; 
  66.     m_pParam2     = NULL; 
  67.     m_pPlatformSpecificData = NULL;
  68. };
  69.     HXThreadMessage(UINT32 ulMessage, void* pParam1, void* pParam2, 
  70.     void* pPlatformSpecificData = NULL)
  71. {
  72.     m_ulMessage     = ulMessage; 
  73.     m_pParam1     = pParam1; 
  74.     m_pParam2     = pParam2;
  75.     m_pPlatformSpecificData = pPlatformSpecificData;
  76. };
  77.   HXThreadMessage(HXThreadMessage* pMsg)
  78.     : m_ulMessage(0),
  79.       m_pParam1(NULL),
  80.       m_pParam2(NULL),
  81.       m_pPlatformSpecificData(NULL)
  82. {
  83.     if( pMsg )
  84.     {
  85.       m_ulMessage     = pMsg->m_ulMessage; 
  86.       m_pParam1     = pMsg->m_pParam1; 
  87.       m_pParam2     = pMsg->m_pParam2;
  88.       m_pPlatformSpecificData = pMsg->m_pPlatformSpecificData;
  89.     }
  90. };
  91.     UINT32  m_ulMessage;
  92.     void*   m_pParam1;
  93.     void*   m_pParam2;
  94.     void*   m_pPlatformSpecificData;
  95. };
  96. enum
  97. {
  98.     HX_CREATE_SUSPENDED = 0x01
  99. };
  100. class HXThread
  101. {
  102. public:
  103.     static  HX_RESULT MakeThread(HXThread*& pThread);
  104.     static  HX_RESULT MakeStubThread(HXThread*& pThread);
  105.     virtual ~HXThread (void);
  106.     virtual HX_RESULT CreateThread
  107. (void* (pExecAddr(void*)), 
  108.  void* pArg,
  109.  ULONG32 ulCreationFlags = 0) = 0;
  110.     virtual HX_RESULT Suspend (void) = 0;
  111.     
  112.     virtual HX_RESULT Resume (void) = 0;
  113.     virtual HX_RESULT SetPriority (UINT32 ulPriority) = 0;
  114.     virtual HX_RESULT GetPriority (UINT32& ulPriority) = 0;
  115.     virtual HX_RESULT YieldTimeSlice (void) = 0;
  116.     virtual HX_RESULT Exit (UINT32 ulExitCode) = 0; 
  117.     virtual HX_RESULT GetThreadId (UINT32& ulThreadId) = 0;
  118.     //Returns *THE CALLING THREADS ID*, not the created thread's id.
  119.     virtual ULONG32     GetCurrentThreadID() = 0;
  120.     virtual HX_RESULT PostMessage(HXThreadMessage* pMsg, void* pWindowHandle = 0) = 0;
  121.     virtual HX_RESULT GetMessage(HXThreadMessage* pMsg, UINT32 ulMsgFilterMix = 0, UINT32 ulMsgFilterMax = 0) = 0;
  122.     virtual HX_RESULT DispatchMessage(HXThreadMessage* pMsg) = 0;
  123. #if defined(HELIX_FEATURE_NETWORK_USE_SELECT)
  124. public:
  125.     conn *  m_pConn; // connection to send loopback msg
  126.     BOOL    m_bUseReaderWriter; // set to true for network thread when local read/writer connected
  127.     virtual void SetNetworkMessageConnection(conn* pConn) {};
  128. #endif // HELIX_FEATURE_NETWORK_USE_SELECT
  129. };
  130. class HXMutex
  131. {
  132. public:
  133.     static  HX_RESULT MakeNamedMutex (HXMutex*& pMutex, char* pName);
  134.     static  HX_RESULT MakeMutex (HXMutex*& pMutex);
  135.     static  HX_RESULT MakeStubMutex (HXMutex*& pMutex);
  136.     virtual ~HXMutex (void) = 0;
  137.     virtual HX_RESULT Lock (void) = 0;
  138.     virtual HX_RESULT   Unlock (void) = 0;
  139.     virtual HX_RESULT   Trylock (void) = 0;
  140. };
  141. class HXEvent
  142. {
  143. public:
  144.     static  HX_RESULT MakeEvent (HXEvent*& pEvent, const char* pEventName = NULL, BOOL bManualReset = TRUE);
  145.     static  HX_RESULT MakeStubEvent (HXEvent*& pEvent, const char* pEventName = NULL, BOOL bManualReset = TRUE);
  146.     virtual ~HXEvent (void) = 0;
  147.     virtual HX_RESULT SignalEvent (void) = 0;
  148.     virtual HX_RESULT ResetEvent (void) = 0;
  149.     virtual void* GetEventHandle (void) = 0;
  150.     virtual HX_RESULT Wait (UINT32 uTimeoutPeriod = ALLFS) = 0;
  151. };
  152. //providing async callbacks.
  153. class HXAsyncTimer
  154. {
  155. public:
  156.     // HXMSG_ASYNC_TIMER messages will be posted to
  157.     // pReceivingThread's message queue every ulTimeOut milliseconds.
  158.     // until KillTimer is called.
  159.     // NOTE: under _WIN32 pReceivingThread is IGNORED and the calling
  160.     // thread is the one to recieve the timer messages (WM_TIMER).
  161.     static UINT32 SetTimer(ULONG32 ulTimeOut, HXThread* pReceivingThread );
  162.     // pfExecFunc will be called every ulTimeOut milliseconds.
  163.     static UINT32 SetTimer(ULONG32 ulTimeOut, TIMERPROC pfExecFunc );
  164.     // ulTimeOut timer is killed/removed.
  165.     static BOOL   KillTimer(UINT32 ulTimerID );
  166. };
  167. #endif /*_HXTHREAD_H_*/