---
title: Create
framework: kernel
role: symbol
role_heading: Type Method
path: kernel/iodispatchqueue/3438189-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);
```

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

## Parameters

- `options`: No options are currently defined. Specify 0 for this parameter.
- `priority`: No priorities are currently defined. Specify 0 for this parameter.

## 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](kernel/iodispatchqueue/3438198-init.md)
- [free](kernel/iodispatchqueue/3438197-free.md)