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

# SetAcquisitionFailure

Sets the error for the box’s acquisition failure.

## Declaration

```occ
kern_return_t SetAcquisitionFailure(kern_return_t in_failure_code);
```

## Parameters

- `in_failure_code`: The box’s acquisition failure.

## 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)
- [SetIsAcquired](videodriverkit/iouservideobox/setisacquired.md)
- [IsAcquired](videodriverkit/iouservideobox/isacquired.md)
- [SetIsAcquirable](videodriverkit/iouservideobox/setisacquirable.md)
- [IsAcquirable](videodriverkit/iouservideobox/isacquirable.md)
- [GetAcquisitionFailure](videodriverkit/iouservideobox/getacquisitionfailure.md)