pr_cexitmonitor.rst (888B)
1 PR_CExitMonitor 2 =============== 3 4 Decrement the entry count associated with a cached monitor. 5 6 7 Syntax 8 ------ 9 10 .. code:: 11 12 #include <prcmon.h> 13 14 PRStatus PR_CExitMonitor(void *address); 15 16 17 Parameters 18 ~~~~~~~~~~ 19 20 The function has the following parameters: 21 22 ``address`` 23 The address of the protected object--the same address previously 24 passed to :ref:`PR_CEnterMonitor`. 25 26 27 Returns 28 ~~~~~~~ 29 30 The function returns one of the following values: 31 32 - If successful, ``PR_SUCCESS``. 33 - If unsuccessful, ``PR_FAILURE``. This may indicate that the address 34 parameter is invalid or that the calling thread is not in the 35 monitor. 36 37 38 Description 39 ----------- 40 41 Using the value specified in the address parameter to find a monitor in 42 the monitor cache, :ref:`PR_CExitMonitor` decrements the entry count 43 associated with the monitor. If the decremented entry count is zero, the 44 monitor is exited.