Locks the specified reader-writer lock in the read mode.
#include <nks/synch.h>
void NXRdLock (
NXRwLock_t *lock);
(IN) Points to the reader-writer lock to be acquired in the read mode.
The hierarchy value of the lock that is being acquired should be greater than any of the locks that are currently held by this context (see NXRwLockAlloc or NXRwLockInit).
If the lock cannot be acquired immediately, the calling thread waits until the lock can be acquired. No assumptions can be made about the way in which the calling thread might wait for the lock to become free. The reader-writer lock is not guaranteed to be FIFO. On return, the calling thread has acquired the specified lock in the read mode.
NKS reader-writer locks are not recursive. Attempting to acquire a recursive read lock causes deadlock.