Locks a complex lock in shared-read mode.
| Item | Description |
|---|---|
| lock_addr | Specifies the address of the lock word to lock. |
The lock_read kernel service locks the specified complex lock in shared-read mode; it blocks if the lock is locked in exclusive-write mode. The lock must previously have been initialized with the lock_init kernel service. The lock_read kernel service has no return values.
The lock_try_read kernel service tries to lock the specified complex lock in shared-read mode; it returns immediately if the lock is locked in exclusive-write mode, otherwise it locks the lock in shared-read mode. The lock must previously have been initialized with the lock_init kernel service.
The lock_read and lock_try_read kernel services can be called from the process environment only.
The lock_try_read kernel service has the following return values:
| Item | Description |
|---|---|
| TRUE | Indicates that the lock was successfully acquired in shared-read mode. |
| FALSE | Indicates that the lock was not acquired. |