<!--
{
  "availability" : [
    "DriverKit: 27.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "VideoDriverKit",
  "identifier" : "/documentation/VideoDriverKit/IOUserVideoBox/HandleChangeAcquireBox",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Method",
  "symbol" : {
    "kind" : "Instance Method",
    "modules" : [
      "VideoDriverKit"
    ],
    "preciseIdentifier" : "c:@S@IOUserVideoBox@F@HandleChangeAcquireBox#b#"
  },
  "title" : "HandleChangeAcquireBox"
}
-->

# HandleChangeAcquireBox

Called when host is attempting to the change the box acquisition

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

## Return Value

kern_return_t inidicating if the change was successful, upon succes the value should be updated.

## 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

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)