> ## 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.

# Visão geral da biblioteca XTaskQueue

> Visão geral da biblioteca XTaskQueue

Use este tópico para gerenciar filas de tarefas com a biblioteca XTaskQueue. Essa biblioteca é responsável pelo "quando" e
pelo "onde" da execução de tarefas, o que é controlado pelas filas de tarefas
e pelos métodos que [configuram](/pt-BR/reference/system/xtaskqueue/functions/xtaskqueuecreate),
[gerenciam](/pt-BR/reference/system/xtaskqueue/functions/xtaskqueuedispatch) e [controlam](/pt-BR/reference/system/xtaskqueue/functions/xtaskqueueregistermonitor) as filas de tarefas.

As filas de tarefas podem ter duas portas definidas para [modos
diferentes](/pt-BR/reference/system/xtaskqueue/enums/xtaskqueuedispatchmode) e despachadas em qualquer thread.
[Retornos de chamada personalizados](/pt-BR/reference/system/xtaskqueue/functions/xtaskqueueregisterwaiter) podem ser adicionados para serem chamados em
circunstâncias especiais, a fim de oferecer funcionalidades.

Cada processo tem uma fila de tarefas padrão que despacha automaticamente suas tarefas de forma simultânea
no pool de threads do sistema. Esse pool de tarefas é usado se nenhuma fila de tarefas for especificada no
[XAsyncBlock](/pt-BR/reference/system/xasync/structs/xasyncblock). Você pode [alterar ou remover](/pt-BR/reference/system/xtaskqueue/functions/xtaskqueuesetcurrentprocesstaskqueue)
a fila de tarefas padrão.

Para obter mais informações sobre as APIs do XTaskQueue, consulte [XTaskQueue](/pt-BR/reference/system/xtaskqueue/xtaskqueue_members).

## XTaskQueueHandle

Quando uma fila de tarefas é criada, ela é acompanhada por um tipo `XTaskQueueHandle`.
Esse identificador identifica a fila de tarefas e é passado para qualquer função da
[biblioteca XTaskQueue](/pt-BR/reference/system/xtaskqueue/xtaskqueue_members) que trabalhe com filas de tarefas. O identificador deve
ser acompanhado e fechado quando a fila de tarefas não estiver mais sendo usada.

Para obter mais informações sobre como limpar filas de tarefas, consulte [Limpar fila de tarefas](/pt-BR/build/core-features/common/async/async-libraries/async-library-xtaskqueue-example-cleanup-task-queue).

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

* [XTaskQueue (conteúdo da API)](/pt-BR/reference/system/xtaskqueue/xtaskqueue_members)
  * Funções
    * [xtaskqueuecreate](/pt-BR/reference/system/xtaskqueue/functions/xtaskqueuecreate)
    * [xtaskqueuedispatch](/pt-BR/reference/system/xtaskqueue/functions/xtaskqueuedispatch)
    * [xtaskqueueregistermonitor](/pt-BR/reference/system/xtaskqueue/functions/xtaskqueueregistermonitor)
    * [xtaskqueueregisterwaiter](/pt-BR/reference/system/xtaskqueue/functions/xtaskqueueregisterwaiter)
    * [xtaskqueuesetcurrentprocesstaskqueue](/pt-BR/reference/system/xtaskqueue/functions/xtaskqueuesetcurrentprocesstaskqueue)
* [xasync (conteúdo da API)](/pt-BR/reference/system/xasync/xasync_members)
  * Estruturas
    * [XAsyncBlock](/pt-BR/reference/system/xasync/structs/xasyncblock)

## Consulte também

[Exemplo: Criar fila de tarefas](/pt-BR/build/core-features/common/async/async-libraries/async-library-xtaskqueue-example-create-task-queue)
[Exemplo: Despachar fila de tarefas](/pt-BR/build/core-features/common/async/async-libraries/async-library-xtaskqueue-example-dispatch-task-queue)
[Exemplo: Limpar fila de tarefas](/pt-BR/build/core-features/common/async/async-libraries/async-library-xtaskqueue-example-cleanup-task-queue)
[XAsync](/pt-BR/reference/system/xasync/xasync_members)
[Projetando a fila de tarefas](/pt-BR/build/core-features/common/async/async-task-queue-design)
[XTaskQueue](/pt-BR/reference/system/xtaskqueue/xtaskqueue_members)


## Related topics

- [Información general de la biblioteca XTaskQueue](/es/build/core-features/common/async/async-libraries/async-library-xtaskqueue.md)
- [Visão geral de portabilidade](/pt-BR/paths/porting/overview.md)
- [Visão geral de Godot e engines da comunidade](/pt-BR/paths/community-engines/overview.md)
- [Visão geral da API C do Services - PFLocalization.h](/pt-BR/services/playfab/api-references/c/pflocalization/pflocalization_members.md)
- [Visão geral do Unity](/pt-BR/paths/unity/overview.md)