win_ce_semaphore.c
上传用户:sun1608
上传日期:2007-02-02
资源大小:6116k
文件大小:8k
源码类别:

流媒体/Mpeg4/MP4

开发平台:

Visual C++

  1. /* win_ce_semaphore.c
  2.    Copyright (c) 1998, Johnson M. Hart
  3.    (with corrections 2001 by Rainer Loritz)
  4.    Permission is granted for any and all use providing that this
  5.    copyright is properly acknowledged.
  6.    There are no assurances of suitability for any use whatsoever.
  7.    WINDOWS CE: There is a collection of Windows CE functions to simulate
  8.    semaphores using only a mutex and an event. As Windows CE events cannot
  9.    be named, these simulated semaphores cannot be named either.
  10.    Implementation notes:
  11.    1. All required internal data structures are allocated on the process's heap.
  12.    2. Where appropriate, a new error code is returned (see the header
  13.       file), or, if the error is a Win32 error, that code is unchanged.
  14.    3. Notice the new handle type "SYNCHHANDLE" that has handles, counters,
  15.       and other information. This structure will grow as new objects are added
  16.       to this set; some members are specific to only one or two of the objects.
  17.    4. Mutexes are used for critical sections. These could be replaced with
  18.       CRITICAL_SECTION objects but then this would give up the time out
  19.       capability.
  20.    5. The implementation shows several interesting aspects of synchronization, some
  21.       of which are specific to Win32 and some of which are general. These are pointed
  22.       out in the comments as appropriate.
  23.    6. The wait function emulates WaitForSingleObject only. An emulation of
  24.       WaitForMultipleObjects is much harder to implement outside the kernel,
  25.       and it is not clear how to handle a mixture of WCE semaphores and normal
  26.       events and mutexes. */
  27. #include <windows.h>
  28. #include "win_ce_semaphore.h"
  29. static SYNCHHANDLE CleanUp (SYNCHHANDLE hSynch, DWORD Flags);
  30. SYNCHHANDLE CreateSemaphoreCE (
  31.    LPSECURITY_ATTRIBUTES lpSemaphoreAttributes,  /* pointer to security attributes */
  32.       LONG lInitialCount,   /* initial count */
  33.       LONG lMaximumCount,   /* maximum count */
  34.       LPCTSTR lpName )
  35. /* Semaphore for use with Windows CE that does not support them directly.
  36.    Requires a counter, a mutex to protect the counter, and an
  37.    autoreset event.
  38.    Here are the rules that must always hold between the autoreset event
  39.    and the mutex (any violation of these rules by the CE semaphore functions
  40.    will, in all likelihood, result in a defect):
  41.     1. No thread can set, pulse, or reset the event,
  42.        nor can it access any part of the SYNCHHANDLE structure,
  43.        without first gaining ownership of the mutex.
  44.        BUT, a thread can wait on the event without owning the mutex
  45.        (this is clearly necessary or else the event could never be set).
  46.     2. The event is in a signaled state if and only if the current semaphore
  47.        count ("CurCount") is greater than zero.
  48.     3. The semaphore count is always >= 0 and <= the maximum count */
  49. {
  50.    SYNCHHANDLE hSynch = NULL, result = NULL;
  51.    __try
  52. {
  53.       if (lInitialCount > lMaximumCount || lMaximumCount < 0 || lInitialCount < 0) 
  54.   {
  55.               /* Bad parameters */
  56.          SetLastError (SYNCH_ERROR);
  57.          __leave;
  58.       }
  59.       hSynch = HeapAlloc (GetProcessHeap(), HEAP_ZERO_MEMORY, SYNCH_HANDLE_SIZE);
  60.       if (hSynch == NULL) __leave;
  61.       hSynch->MaxCount = lMaximumCount;
  62.       hSynch->CurCount = lInitialCount;
  63.       hSynch->lpName = lpName;
  64.       hSynch->hMutex = CreateMutex (lpSemaphoreAttributes, FALSE, NULL);
  65.       WaitForSingleObject (hSynch->hMutex, INFINITE);
  66.       /*  Create the event. It is initially signaled if and only if the
  67.           initial count is > 0 */
  68.       hSynch->hEvent = CreateEvent (lpSemaphoreAttributes, FALSE, 
  69.               lInitialCount > 0, NULL);
  70.       ReleaseMutex (hSynch->hMutex);
  71.       hSynch->hSemph = NULL;
  72.    }
  73.    __finally
  74.    {
  75.        /* Return with the handle, or, if there was any error, return
  76.         a null after closing any open handles and freeing any allocated memory. */
  77.       result=CleanUp(hSynch, 6 /* An event and a mutex, but no semaphore. */);
  78.    }
  79.    return result;
  80. }
  81. BOOL ReleaseSemaphoreCE (SYNCHHANDLE hSemCE, LONG cReleaseCount, LPLONG lpPreviousCount)
  82. /* Windows CE equivalent to ReleaseSemaphore. */
  83. {
  84.    BOOL Result = TRUE;
  85.    /* Gain access to the object to assure that the release count
  86.       would not cause the total count to exceed the maximum. */
  87.    __try 
  88.    {
  89.       WaitForSingleObject (hSemCE->hMutex, INFINITE);
  90.   /* reply only if asked to */
  91.   if (lpPreviousCount!=NULL)
  92.  *lpPreviousCount = hSemCE->CurCount;
  93.       if (hSemCE->CurCount + cReleaseCount > hSemCE->MaxCount || cReleaseCount <= 0)
  94.   {
  95.          SetLastError (SYNCH_ERROR);
  96.          Result = FALSE;
  97.          __leave;
  98.       }
  99.       hSemCE->CurCount += cReleaseCount;
  100.       /*  Set the autoreset event, releasing exactly one waiting thread, now or
  101.           in the future.  */
  102.       SetEvent (hSemCE->hEvent);
  103.    }
  104.    __finally
  105.    {
  106.       ReleaseMutex (hSemCE->hMutex);
  107.    }
  108.    return Result;
  109. }
  110. DWORD WaitForSemaphoreCE (SYNCHHANDLE hSemCE, DWORD dwMilliseconds)
  111.    /* Windows CE semaphore equivalent of WaitForSingleObject. */
  112. {
  113.    DWORD WaitResult;
  114.    WaitResult = WaitForSingleObject (hSemCE->hMutex, dwMilliseconds);
  115.    if (WaitResult != WAIT_OBJECT_0 && WaitResult != WAIT_ABANDONED_0) return WaitResult;
  116.    while (hSemCE->CurCount <= 0) 
  117.    { 
  118.       /* The count is 0, and the thread must wait on the event (which, by
  119.          the rules, is currently reset) for semaphore resources to become
  120.          available. First, of course, the mutex must be released so that another
  121.          thread will be capable of setting the event. */
  122.       ReleaseMutex (hSemCE->hMutex);
  123.       /*  Wait for the event to be signaled, indicating a semaphore state change.
  124.           The event is autoreset and signaled with a SetEvent (not PulseEvent)
  125.           so exactly one waiting thread (whether or not there is currently
  126.           a waiting thread) is released as a result of the SetEvent. */
  127.       WaitResult = WaitForSingleObject (hSemCE->hEvent, dwMilliseconds);
  128.       if (WaitResult != WAIT_OBJECT_0) return WaitResult;
  129.       /*  This is where the properties of setting of an autoreset event is critical
  130.           to assure that, even if the semaphore state changes between the
  131.           preceding Wait and the next, and even if NO threads are waiting
  132.           on the event at the time of the SetEvent, at least one thread
  133.           will be released. 
  134.           Pulsing a manual reset event would appear to work, but it would have
  135.           a defect which could appear if the semaphore state changed between
  136.           the two waits. */
  137.       WaitResult = WaitForSingleObject (hSemCE->hMutex, dwMilliseconds);
  138.       if (WaitResult != WAIT_OBJECT_0 && WaitResult != WAIT_ABANDONED_0) return WaitResult;
  139.    }
  140.    /* The count is not zero and this thread owns the mutex.  */
  141.    hSemCE->CurCount--;
  142.    /* The event is now unsignaled, BUT, the semaphore count may not be
  143.       zero, in which case the event should be signaled again
  144.       before releasing the mutex. */
  145.    if (hSemCE->CurCount > 0) SetEvent (hSemCE->hEvent);
  146.    ReleaseMutex (hSemCE->hMutex);
  147.    return WaitResult;
  148. }
  149. BOOL CloseSynchHandle (SYNCHHANDLE hSynch)
  150. /* Close a synchronization handle. 
  151.    Improvement: Test for a valid handle before dereferencing the handle. */
  152. {
  153.    BOOL Result = TRUE;
  154.    if (hSynch->hEvent != NULL) Result = Result && CloseHandle (hSynch->hEvent);
  155.    if (hSynch->hMutex != NULL) Result = Result && CloseHandle (hSynch->hMutex);
  156.    if (hSynch->hSemph != NULL) Result = Result && CloseHandle (hSynch->hSemph);
  157.    HeapFree (GetProcessHeap (), 0, hSynch);
  158.    return (Result);
  159. }
  160. static SYNCHHANDLE CleanUp (SYNCHHANDLE hSynch, DWORD Flags)
  161. { /* Prepare to return from a create of a synchronization handle.
  162.      If there was any failure, free any allocated resources.
  163.      "Flags" indicates which Win32 objects are required in the 
  164.      synchronization handle. */
  165.    BOOL ok = TRUE;
  166.    if (hSynch == NULL) return NULL;
  167.    if (Flags & 4 == 1 && hSynch->hEvent == NULL) ok = FALSE;
  168.    if (Flags & 2 == 1 && hSynch->hMutex == NULL) ok = FALSE;
  169.    if (Flags & 1 == 1 && hSynch->hEvent == NULL) ok = FALSE;
  170.    if (!ok) 
  171.    {
  172.       CloseSynchHandle (hSynch);
  173.       return NULL;
  174.    }
  175.    /* Everything worked */
  176.    return hSynch;
  177. }