---
title: IORecursiveLockTryLock
framework: driverkit
role: symbol
role_heading: Function
path: driverkit/iorecursivelocktrylock
---

# IORecursiveLockTryLock

## Declaration

```occ
bool IORecursiveLockTryLock(struct IORecursiveLock *lock);
```

## Parameters

- `lock`: Pointer to the allocated lock.

## Return Value

Return Value True if the lock is now locked by the caller, otherwise false.

## Discussion

Discussion Attempt to lock a recursive lock. Lock the lock if it is currently unlocked, or held by the calling thread, and return true. If the lock is held by another thread, return false. Successful calls to IORecursiveLockTryLock should be balanced with calls to IORecursiveLockUnlock.

## See Also

### Functions

- [dequeue_head](driverkit/dequeue_head.md)
- [dequeue_tail](driverkit/dequeue_tail.md)
- [enqueue_head](driverkit/enqueue_head.md)
- [enqueue_tail](driverkit/enqueue_tail.md)
- [get_IOHistogramReporter_IVars](driverkit/get_iohistogramreporter_ivars-4lwpg.md)
- [get_IOHistogramReporter_IVars](driverkit/get_iohistogramreporter_ivars-5lkdv.md)
- [get_IOReporter_IVars](driverkit/get_ioreporter_ivars-6q8vt.md)
- [get_IOReporter_IVars](driverkit/get_ioreporter_ivars-89ntc.md)
- [get_IOStateReporter_IVars](driverkit/get_iostatereporter_ivars-3g28i.md)
- [get_IOStateReporter_IVars](driverkit/get_iostatereporter_ivars-56435.md)
- [insque](driverkit/insque.md)
- [IOCallOnce](driverkit/iocallonce.md)
- [IOLockAlloc](driverkit/iolockalloc.md)
- [IOLockAssert](driverkit/iolockassert.md)
- [IOLockFree](driverkit/iolockfree.md)