SetDispatchQueue
Associates a custom dispatch queue with the service and assigns the specified name to it.
Declaration
virtual kern_return_t SetDispatchQueue(const IODispatchQueueName name, IODispatchQueue *queue);Parameters
- name:
The name to assign to the queue. Use this name with the Queuename macro to designate where you want the methods of your class to execute. Include that macro at the end of your method signature methods in the
.iigfile of your class. - queue:
The queue to associate with the service. The service retains the queue you provide.
Return Value
kIOReturnSuccess on success, or another value if an error occurs. For a list of error codes, see Error Codes.
Discussion
In your driver’s Start method, call this method once for each unique queue name you designated in your class definition file. This method registers the dispatch queue with that name and assigns it to your service. When calling the methods of your service, DriverKit uses the appropriate dispatch queue. If DriverKit calls a method before you set the dispatch queue that method uses, the method runs on the default queue.
DriverKit creates a default dispatch queue for every service. To replace the default queue that DriverKit provides, call this method and specify kIOServiceDefaultQueueName for the name parameter.