SetAcquisitionFailure
Sets the error code to return when box acquisition fails.
Declaration
kern_return_t SetAcquisitionFailure(kern_return_t in_failure_code);Parameters
- in_failure_code:
An error code to return when box acquisition fails.
Return Value
kIOReturnSuccess on success, or another value if an error occurs. For a list of error codes, see Error Codes.
Discussion
Set this code to provide the error to return from failed calls to HandleChangeAcquireBox.
If successful, changing the acquisition failure code sends a notification to the host to update the object state.
This method synchronizes by using the work queue created by the object.