VThread.hxx
上传用户:sy_wanhua
上传日期:2013-07-25
资源大小:3048k
文件大小:7k
源码类别:

流媒体/Mpeg4/MP4

开发平台:

C/C++

  1. #ifndef VTHREAD_HXX_
  2. #define VTHREAD_HXX_
  3. /* ====================================================================
  4.  * The Vovida Software License, Version 1.0 
  5.  * 
  6.  * Copyright (c) 2000 Vovida Networks, Inc.  All rights reserved.
  7.  * 
  8.  * Redistribution and use in source and binary forms, with or without
  9.  * modification, are permitted provided that the following conditions
  10.  * are met:
  11.  * 
  12.  * 1. Redistributions of source code must retain the above copyright
  13.  *    notice, this list of conditions and the following disclaimer.
  14.  * 
  15.  * 2. Redistributions in binary form must reproduce the above copyright
  16.  *    notice, this list of conditions and the following disclaimer in
  17.  *    the documentation and/or other materials provided with the
  18.  *    distribution.
  19.  * 
  20.  * 3. The names "VOCAL", "Vovida Open Communication Application Library",
  21.  *    and "Vovida Open Communication Application Library (VOCAL)" must
  22.  *    not be used to endorse or promote products derived from this
  23.  *    software without prior written permission. For written
  24.  *    permission, please contact vocal@vovida.org.
  25.  *
  26.  * 4. Products derived from this software may not be called "VOCAL", nor
  27.  *    may "VOCAL" appear in their name, without prior written
  28.  *    permission of Vovida Networks, Inc.
  29.  * 
  30.  * THIS SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESSED OR IMPLIED
  31.  * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
  32.  * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, TITLE AND
  33.  * NON-INFRINGEMENT ARE DISCLAIMED.  IN NO EVENT SHALL VOVIDA
  34.  * NETWORKS, INC. OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT DAMAGES
  35.  * IN EXCESS OF $1,000, NOR FOR ANY INDIRECT, INCIDENTAL, SPECIAL,
  36.  * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
  37.  * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
  38.  * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
  39.  * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  40.  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
  41.  * USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
  42.  * DAMAGE.
  43.  * 
  44.  * ====================================================================
  45.  * 
  46.  * This software consists of voluntary contributions made by Vovida
  47.  * Networks, Inc. and many individuals on behalf of Vovida Networks,
  48.  * Inc.  For more information on Vovida Networks, Inc., please see
  49.  * <http://www.vovida.org/>.
  50.  *
  51.  */
  52. static const char* const VThread_hxx_version =
  53.     "$Id: VThread.hxx,v 1.1 2001/06/29 03:41:33 bko Exp $";
  54. #include "VTime.hxx"
  55. #include "VThreadException.hxx"
  56. /********************************************************************
  57.   OS independent definitions
  58. ********************************************************************/
  59. // VThread priorities
  60. const unsigned long VTHREAD_PRIORITY_DEFAULT = 0;
  61. // VThread stack
  62. const unsigned long VTHREAD_STACK_SIZE_DEFAULT = 131072; // in bytes -- 2 ^ 17
  63. // VThread flags
  64. const unsigned long VTHREAD_SCHED_MASK = 0x0000000f;
  65. const unsigned long VTHREAD_SCHED_DEFAULT = 0x00000001;
  66. const unsigned long VTHREAD_SCHED_FIFO = 0x00000002;
  67. const unsigned long VTHREAD_SCHED_RR = 0x00000004;
  68. /********************************************************************
  69.   OS dependent definitions
  70. ********************************************************************/
  71. #include "VThread_vxworks.hxx"
  72. #include "VThread_posix.hxx"
  73. // VThread constants
  74. const vthread_t VTHREAD_ID_INVALID = 0;
  75. /** Class VThread
  76.  ** Defines a simple thread class which provides
  77.  ** means of controlling a separate thread of control in which
  78.  ** the scheduling mechanism and priority may be specified. Other
  79.  ** potentially operating system dependent capabilites are
  80.  ** provided in generic fashion as deemed necessary and useful.
  81.  **
  82.  ** Each instance of the class supports one thread of execution.
  83.  ** Creating multiple threads requires creating multiple VThread objects.
  84.  **
  85.  ** The following exceptions may be thrown by methods of this class:
  86.  ** VExceptionMemory(),
  87.  ** VThreadExceptionInvalidAttributes(),
  88.  ** VThreadExceptionInvalidPriority()
  89.  **/
  90. class VThread
  91. {
  92.     public:
  93.         /**
  94.          ** Create an empty VThread object
  95.          ** Note, this does NOT start a new thread of control
  96.          ** associated with the VThread.
  97.          */
  98.         VThread( );
  99.         /**
  100.          ** Delete a VThread object
  101.          ** Note, this does not stop the thread of control
  102.          ** associated with the VThread.
  103.          */
  104.         virtual ~VThread( );
  105.         /**
  106.          ** Creates a new thread of control, with the specified attributes,
  107.          ** running startFunc with startArgs.
  108.          **
  109.          ** The flags are a bitwise-OR of the following:
  110.          ** VTHREAD_SCHED_FIFO, VTHREAD_SCHED_RR, VTHREAD_SCHED_DEFAULT,
  111.          **( rest not supported yet)
  112.          ** VTHREAD_CANCEL_DISABLE, VTHREAD_CANCEL_ENABLE, 
  113.          ** VTHREAD_CANCEL_DEFERRED, VTHREAD_CANCEL_ASYNCHRONOUS,
  114.          ** VTHREAD_BOUND, VTHREAD_NEW_LWP, VTHREAD_DETACHED,
  115.          ** VTHREAD_SUSPENDED, VTHREAD_DAEMON, VTHREAD_JOINABLE,
  116.          **
  117.          ** By default, or if priority is set to
  118.          ** VTHREAD_PRIORITY_DEFAULT, an "appropriate" priority
  119.          ** value for the given scheduling policy (specified in flags,
  120.          ** e.g., VTHREAD_SCHED_DEFAULT) is used. This value is calculated
  121.          ** dynamically, and is the median value between the minimum
  122.          ** and maximum priority values for the given policy. If an
  123.          ** explicit value is given, it is used. Note that actual
  124.          ** priority values are EXTREMEMLY implementation-dependent,
  125.          ** and are probably best avoided.
  126.          ** 
  127.          ** The following exceptions may be thrown by this method:
  128.          ** VThreadExceptionInvalidAttributes(),
  129.          ** VThreadExceptionInvalidPriority()
  130.          **
  131.          ** Returns 0, if successful, or a negative error code.
  132.          */
  133.         int
  134.         spawn( void *(*startFunc)(void *),
  135.                void *startArgs = 0,
  136.                unsigned long flags = 0,
  137.                unsigned long priority = VTHREAD_PRIORITY_DEFAULT,
  138.                unsigned long stack_size = VTHREAD_STACK_SIZE_DEFAULT
  139.              ) throw (VThreadException&);
  140.         /**
  141.          ** Wait for thread to exit. Returns 0 if successful, or a
  142.          ** negative error code.
  143.          */
  144.         int
  145.         join( void **status = 0 );
  146.         /**
  147.          ** Returns the priority of the thread
  148.          */
  149.         int
  150.         getPriority() const;
  151.         /**
  152.          ** Set the priority of the thread. Returns 0 if successful, or a
  153.          ** negative error code.
  154.          **
  155.          ** The following exceptions may be thrown by this method:
  156.          ** VThreadExceptionInvalidPriority()
  157.          **/
  158.         int
  159.         setPriority( int priority ) throw(VThreadExceptionInvalidPriority&);
  160.         /**
  161.          ** Return the unique Id of the VThread
  162.          */
  163.         const vthread_t*
  164.         getId() const;
  165.         /**
  166.          ** Return ptr to the os specific attributes of the VThread
  167.          */
  168.         const vthread_attr_t*
  169.         getAttributes() const;
  170.         /**
  171.          ** Exit the current thread of control associated with the VThread 
  172.          */
  173.         void
  174.         exit();
  175.         /**
  176.            Return the VThread ID of the current process
  177.         */
  178.         static const vthread_t
  179.         selfId ();
  180.     private:
  181.         vthread_t myId;
  182.         vthread_attr_t myAttributes;
  183. };
  184. // VTHREAD_H_
  185. #endif