37 lines
832 B
Markdown
37 lines
832 B
Markdown
# PR_CExitMonitor
|
|
|
|
Decrement the entry count associated with a cached monitor.
|
|
|
|
## Syntax
|
|
|
|
```{code}
|
|
#include <prcmon.h>
|
|
|
|
PRStatus PR_CExitMonitor(void *address);
|
|
```
|
|
|
|
### Parameters
|
|
|
|
The function has the following parameters:
|
|
|
|
`address`
|
|
|
|
: The address of the protected object--the same address previously
|
|
passed to {ref}`PR_CEnterMonitor`.
|
|
|
|
### Returns
|
|
|
|
The function returns one of the following values:
|
|
|
|
- If successful, `PR_SUCCESS`.
|
|
- If unsuccessful, `PR_FAILURE`. This may indicate that the address
|
|
parameter is invalid or that the calling thread is not in the
|
|
monitor.
|
|
|
|
## Description
|
|
|
|
Using the value specified in the address parameter to find a monitor in
|
|
the monitor cache, {ref}`PR_CExitMonitor` decrements the entry count
|
|
associated with the monitor. If the decremented entry count is zero, the
|
|
monitor is exited.
|