44 lines
884 B
ReStructuredText
44 lines
884 B
ReStructuredText
PR_ExitMonitor
|
|
==============
|
|
|
|
Decrements the entry count associated with a specified monitor and, if
|
|
the entry count reaches zero, releases the monitor's lock.
|
|
|
|
|
|
Syntax
|
|
------
|
|
|
|
.. code::
|
|
|
|
#include <prmon.h>
|
|
|
|
PRStatus PR_ExitMonitor(PRMonitor *mon);
|
|
|
|
|
|
Parameter
|
|
~~~~~~~~~
|
|
|
|
The function has the following parameter:
|
|
|
|
``mon``
|
|
A reference to an existing structure of type :ref:`PRMonitor`. The
|
|
monitor object referenced must be one for which the calling thread
|
|
currently holds the lock.
|
|
|
|
|
|
Returns
|
|
~~~~~~~
|
|
|
|
The function returns one of the following values:
|
|
|
|
- If successful, ``PR_SUCCESS``.
|
|
- If unsuccessful (the calling thread has not entered the monitor),
|
|
``PR_FAILURE``.
|
|
|
|
|
|
Description
|
|
-----------
|
|
|
|
If the decremented entry count is zero, :ref:`PR_ExitMonitor` releases the
|
|
monitor's lock. Threads that were blocked trying to enter the monitor
|
|
will be rescheduled.
|