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

# Exemplo de criação de fila de tarefas

> Mostra como chamar XTaskQueueCreate com um modo de despacho para cada porta, como ThreadPool, Manual ou Immediate, e salvar o XTaskQueueHandle retornado.

Este tópico fornece um exemplo de como criar uma fila de tarefas. Basta chamar [XTaskQueueCreate](https://docs.xbox.com/pt-BR/reference/system/xtaskqueue/functions/xtaskqueuecreate.md),
passar os [modos](https://docs.xbox.com/pt-BR/reference/system/xtaskqueue/enums/xtaskqueuedispatchmode.md) de cada porta e, em seguida, salvar o identificador criado.

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

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

Se não houver erro no código de retorno, a fila de tarefas passa a ser
representada pelo `XTaskQueueHandle` retornado.

## Documentação de referência da API

* [XTaskQueue (conteúdo da API)](https://docs.xbox.com/pt-BR/reference/system/xtaskqueue/xtaskqueue_members.md)
  * Funções
    * [XTaskQueueCreate](https://docs.xbox.com/pt-BR/reference/system/xtaskqueue/functions/xtaskqueuecreate.md)

## Consulte também

[Visão geral da biblioteca XTaskQueue](https://docs.xbox.com/pt-BR/build/core-features/common/async/async-libraries/async-library-xtaskqueue.md)

[Despachar fila de tarefas (exemplo)](https://docs.xbox.com/pt-BR/build/core-features/common/async/async-libraries/async-library-xtaskqueue-example-dispatch-task-queue.md)

[Limpar fila de tarefas (exemplo)](https://docs.xbox.com/pt-BR/build/core-features/common/async/async-libraries/async-library-xtaskqueue-example-cleanup-task-queue.md)

[Projetando a fila de tarefas](https://docs.xbox.com/pt-BR/build/core-features/common/async/async-task-queue-design.md)

[XTaskQueue](https://docs.xbox.com/pt-BR/reference/system/xtaskqueue/xtaskqueue_members.md)


## Related topics

- [Bibliotecas XAsync para programação de tarefas assíncronas](https://docs.xbox.com/pt-BR/build/core-features/common/async/async-libraries/index.md)
- [Exemplo de limpeza da fila de tarefas](https://docs.xbox.com/pt-BR/build/core-features/common/async/async-libraries/async-library-xtaskqueue-example-cleanup-task-queue.md)
- [Exemplo de despacho da fila de tarefas](https://docs.xbox.com/pt-BR/build/core-features/common/async/async-libraries/async-library-xtaskqueue-example-dispatch-task-queue.md)
- [Design da fila de tarefas assíncronas](https://docs.xbox.com/pt-BR/build/core-features/common/async/async-task-queue-design.md)
- [Como: Criar uma fila de tarefas composta](https://docs.xbox.com/pt-BR/build/core-features/common/async/async-task-queue-design-howto/creating-composite-task-queue.md)