open(serviceQueue:completionHandler:)

Declaration

func open(serviceQueue: dispatch_queue_t?, completionHandler: @escaping  @Sendable (IOUSBHostDevice, (any Error)?) -> Void)

func open(serviceQueue: dispatch_queue_t?) async throws -> IOUSBHostDevice

Parameters

• serviceQueue:

  A serial queue that the app uses to service all the asynchronous requests it submits to the default control endpoint. By default the framework creates an internal serial queue for the client process.

• completionHandler:

  The block the framework calls after the client has successfully opened the USB accessory. The error parameter passed to the block is nil if the operation was successful. The framework invokes the block on an arbitrary thread.

Discussion

This operation opens a connection to the USB accessory for exclusive access and returns its IOUSBHostDevice object. An app can call this multiple times, subsequent calls will return the same IOUSBHostDevice instance.

When the process no longer needs exclusive access to this accessory, call close(completionHandler:) to close the accessory. This will close all open connections to the accessory and invalidate all the IOUSBHostDevice objects.

See Also

Managing a USB accessory

• close(completionHandler:)