---
title: Create
framework: driverkit
role: symbol
role_heading: Static Method
path: driverkit/iodispatchqueue/create
---

# Create

Creates a new dispatch queue object.

## Declaration

```occ
static kern_return_t Create(const IODispatchQueueName name, uint64_t options, uint64_t priority, IODispatchQueue **queue);
```

## Parameters

- `name`: The name of the queue.
- `options`: No options are currently defined. Specify 0 for this parameter.
- `priority`: No priorities are currently defined. Specify 0 for this parameter.
- `queue`: The created queue.

## Return Value

Return Value kIOReturnSuccess on success, or another value if an error occurs. For a list of error codes, see Error Codes.

## Discussion

Discussion Creates a new dispatch queue object. All queues are currently serial, executing one block at time in FIFO order. The new object has retain count of 1 and should be released by the caller.

## See Also

### Creating a Dispatch Queue

- [init](driverkit/iodispatchqueue/init.md)
- [free](driverkit/iodispatchqueue/free.md)