---
title: SetIsAcquirable
framework: audiodriverkit
role: symbol
role_heading: Instance Method
path: audiodriverkit/iouseraudiobox/setisacquirable
---

# SetIsAcquirable

Set the box’s acquirability state.

## Declaration

```occ
kern_return_t SetIsAcquirable(bool in_is_acquirable);
```

## Parameters

- `in_is_acquirable`: The new value of the box’s acquirability state.

## Return Value

Return Value kIOReturnSuccess on success, or another value if an error occurs. For a list of error codes, see Error Codes.

## Discussion

Discussion If successful, changing the acquirability state sends a notification to the host to update the object state. This method synchronizes by using the work queue created by the object.

## See Also

### Managing Acquirability

- [HandleChangeAcquireBox](audiodriverkit/iouseraudiobox/handlechangeacquirebox.md)
- [SetIsAcquired](audiodriverkit/iouseraudiobox/setisacquired.md)
- [IsAcquired](audiodriverkit/iouseraudiobox/isacquired.md)
- [IsAcquirable](audiodriverkit/iouseraudiobox/isacquirable.md)
- [SetAcquisitionFailure](audiodriverkit/iouseraudiobox/setacquisitionfailure.md)
- [GetAcquisitionFailure](audiodriverkit/iouseraudiobox/getacquisitionfailure.md)