Promotes all threads waiting on a specified monitor to a ready state.
The function has the following parameter:
- A reference to an existing structure of type
PRMonitor. The monitor object referenced must be one for which the calling thread currently holds the lock.
The function returns one of the following values:
- If successful,
- If unsuccessful,
A call to
PR_NotifyAll causes all of the threads waiting on the monitor to be scheduled to be promoted to a ready state. If no threads are waiting, the operation is no-op.
PR_NotifyAll should be used with some care. The expense of scheduling multiple threads increases dramatically as the number of threads increases.