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

# SetIsAcquired

Sets the value indicating the box’s acquisition state.

## Declaration

```occ
kern_return_t SetIsAcquired(bool in_is_acquired);
```

## Parameters

- `in_is_acquired`: The box’s acquisition state.

## Discussion

Discussion The object sends a notification to the host to update the object state on success. The object’s work queue synchronizes access to the value.

## See Also

### Managing acquirability

- [HandleChangeAcquireBox](videodriverkit/iouservideobox/handlechangeacquirebox.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)