---
title: HandleChangeAcquireBox
framework: VideoDriverKit
role: symbol
role_heading: Instance Method
platforms: [driverkit 27.0+]
path: videodriverkit/iouservideobox/handlechangeacquirebox
---

# HandleChangeAcquireBox

Called when host is attempting to the change the box acquisition

## Declaration

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

## Return Value

Return Value Kern_return_t inidicating if the change was successful, upon succes the value should be updated.

## Discussion

Discussion Default behavior will call SetIsAcquired() and return kIOReturnSuccess. Custom drivers should override this method and validate the change and return kIOReturnSuccess to confirm the change

## See Also

### Managing acquirability

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