> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create task queue example

> Create task queue example

This topic provides an example of how to create a task queue. Simply call [XTaskQueueCreate](/reference/system/xtaskqueue/functions/xtaskqueuecreate),
pass in the [modes](/reference/system/xtaskqueue/enums/xtaskqueuedispatchmode) for each port, and then save the created handle.

```c++ theme={null}
XTaskQueueHandle taskQueue1;
HRESULT hr = XTaskQueueCreate(
    XTaskQueueDispatchMode::ThreadPool,
    XTaskQueueDispatchMode::Manual,
    &taskQueue1);

XTaskQueueHandle taskQueue2;
hr = XTaskQueueCreate(
    XTaskQueueDispatchMode::Immediate,
    XTaskQueueDispatchMode::SerializedThreadPool,
    &taskQueue2);
```

If there isn't an error with the return code, the task queue is now
represented by the returned `XTaskQueueHandle`.

## Reference API documentation

* [XTaskQueue (API contents)](/reference/system/xtaskqueue/xtaskqueue_members)
  * Functions
    * [XTaskQueueCreate](/reference/system/xtaskqueue/functions/xtaskqueuecreate)

## See also

[XTaskQueue library overview](/build/core-features/common/async/async-libraries/async-library-xtaskqueue)

[Dispatch task queue (example)](/build/core-features/common/async/async-libraries/async-library-xtaskqueue-example-dispatch-task-queue)

[Clean up task queue (example)](/build/core-features/common/async/async-libraries/async-library-xtaskqueue-example-cleanup-task-queue)

[Designing the task queue](/build/core-features/common/async/async-task-queue-design)

[XTaskQueue](/reference/system/xtaskqueue/xtaskqueue_members)


## Related topics

- [Dispatch task queue example](/build/core-features/common/async/async-libraries/async-library-xtaskqueue-example-dispatch-task-queue.md)
- [Clean up task queue example](/build/core-features/common/async/async-libraries/async-library-xtaskqueue-example-cleanup-task-queue.md)
- [XTaskQueue library overview](/build/core-features/common/async/async-libraries/async-library-xtaskqueue.md)
- [XAsync libraries for asynchronous task programming](/build/core-features/common/async/async-libraries/index.md)
- [XTaskQueueCreate](/reference/system/xtaskqueue/functions/xtaskqueuecreate.md)