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

# Visão geral da biblioteca XTaskQueue

> Saiba como a biblioteca XTaskQueue controla quando e onde as tarefas são executadas, incluindo modos de despacho de porta, a fila de tarefas padrão do processo e XTaskQueueHandle.

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](https://docs.xbox.com/pt-BR/reference/system/xtaskqueue/functions/xtaskqueuecreate.md),
[gerenciam](https://docs.xbox.com/pt-BR/reference/system/xtaskqueue/functions/xtaskqueuedispatch.md) e [controlam](https://docs.xbox.com/pt-BR/reference/system/xtaskqueue/functions/xtaskqueueregistermonitor.md) as filas de tarefas.

As filas de tarefas podem ter duas portas definidas para [modos
diferentes](https://docs.xbox.com/pt-BR/reference/system/xtaskqueue/enums/xtaskqueuedispatchmode.md) e despachadas em qualquer thread.
[Retornos de chamada personalizados](https://docs.xbox.com/pt-BR/reference/system/xtaskqueue/functions/xtaskqueueregisterwaiter.md) 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](https://docs.xbox.com/pt-BR/reference/system/xasync/structs/xasyncblock.md). Você pode [alterar ou remover](https://docs.xbox.com/pt-BR/reference/system/xtaskqueue/functions/xtaskqueuesetcurrentprocesstaskqueue.md)
a fila de tarefas padrão.

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

## 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](https://docs.xbox.com/pt-BR/reference/system/xtaskqueue/xtaskqueue_members.md) 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](https://docs.xbox.com/pt-BR/build/core-features/common/async/async-libraries/async-library-xtaskqueue-example-cleanup-task-queue.md).

## 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)
    * [xtaskqueuedispatch](https://docs.xbox.com/pt-BR/reference/system/xtaskqueue/functions/xtaskqueuedispatch.md)
    * [xtaskqueueregistermonitor](https://docs.xbox.com/pt-BR/reference/system/xtaskqueue/functions/xtaskqueueregistermonitor.md)
    * [xtaskqueueregisterwaiter](https://docs.xbox.com/pt-BR/reference/system/xtaskqueue/functions/xtaskqueueregisterwaiter.md)
    * [xtaskqueuesetcurrentprocesstaskqueue](https://docs.xbox.com/pt-BR/reference/system/xtaskqueue/functions/xtaskqueuesetcurrentprocesstaskqueue.md)
* [xasync (conteúdo da API)](https://docs.xbox.com/pt-BR/reference/system/xasync/xasync_members.md)
  * Estruturas
    * [XAsyncBlock](https://docs.xbox.com/pt-BR/reference/system/xasync/structs/xasyncblock.md)

## Consulte também

[Exemplo: Criar fila de tarefas](https://docs.xbox.com/pt-BR/build/core-features/common/async/async-libraries/async-library-xtaskqueue-example-create-task-queue.md)
[Exemplo: Despachar fila de tarefas](https://docs.xbox.com/pt-BR/build/core-features/common/async/async-libraries/async-library-xtaskqueue-example-dispatch-task-queue.md)
[Exemplo: Limpar fila de tarefas](https://docs.xbox.com/pt-BR/build/core-features/common/async/async-libraries/async-library-xtaskqueue-example-cleanup-task-queue.md)
[XAsync](https://docs.xbox.com/pt-BR/reference/system/xasync/xasync_members.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

- [XTaskQueue (conteúdo da API)](https://docs.xbox.com/pt-BR/reference/system/xtaskqueue/xtaskqueue_members.md)
- [XTaskQueueSetCurrentProcessTaskQueue](https://docs.xbox.com/pt-BR/reference/system/xtaskqueue/functions/xtaskqueuesetcurrentprocesstaskqueue.md)
- [XTaskQueueCreate](https://docs.xbox.com/pt-BR/reference/system/xtaskqueue/functions/xtaskqueuecreate.md)
- [XTaskQueueDispatch](https://docs.xbox.com/pt-BR/reference/system/xtaskqueue/functions/xtaskqueuedispatch.md)
- [XTaskQueueMonitorCallback](https://docs.xbox.com/pt-BR/reference/system/xtaskqueue/functions/xtaskqueuemonitorcallback.md)