---
title: HandleChangeAcquireBox
framework: audiodriverkit
role: symbol
role_heading: Instance Method
path: audiodriverkit/iouseraudiobox/handlechangeacquirebox
---

# HandleChangeAcquireBox

Informs the box of a change to its acquisition state.

## Declaration

```occ
virtual kern_return_t HandleChangeAcquireBox(bool in_acquire);
```

## Parameters

- `in_acquire`: A Boolean value that indicates the acquisition state. If this value is true, the box is being acquired.

## 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 The default implementation calls SetIsAcquired and return kIOReturnSuccess. Custom drivers should override this method to validate the change, then return kIOReturnSuccess to confirm the change. If acquisition fails, return the error code returned from GetAcquisitionFailure.

## See Also

### Managing Acquirability

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