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

# Exemple de distribution d'une file d'attente de tâches

> Montre comment créer un thread dédié qui appelle XTaskQueueDispatch en boucle sur le port d'achèvement, afin que les rappels s'exécutent jusqu'à l'arrêt de la file d'attente de tâches.

Cette rubrique fournit un exemple de distribution d'une file d'attente de tâches. La distribution d'une file d'attente de tâches est nécessaire pour chaque port [manuel](https://docs.xbox.com/fr-CA/reference/system/xtaskqueue/enums/xtaskqueuedispatchmode.md). La façon et
le moment dont les ports sont [distribués](https://docs.xbox.com/fr-CA/reference/system/xtaskqueue/functions/xtaskqueuedispatch.md) déterminent le comportement en matière de threads et de
concurrence des rappels mis en file d'attente.

```c++ theme={null}
std::thread dispatherThread = std::thread(
    [taskQueue]()
    {
        while (true)
        {
            bool processed = XTaskQueueDispatch(taskQueue,
                XTaskQueuePort::Completion, INFINITE);

            if (!processed)
            {
                // The task queue has been terminated, so return.
                break;
            }
        }
    });
```

Cet exemple montre la création d'un thread supplémentaire chargé de distribuer constamment
le port d'achèvement de la file d'attente de tâches passée jusqu'à ce qu'elle soit
arrêtée.

## Documentation de référence de l'API

* [XTaskQueue (contenu de l'API)](https://docs.xbox.com/fr-CA/reference/system/xtaskqueue/xtaskqueue_members.md)
  * Fonctions
    * [xtaskqueuedispatch](https://docs.xbox.com/fr-CA/reference/system/xtaskqueue/functions/xtaskqueuedispatch.md)

## Voir aussi

[Vue d'ensemble de la bibliothèque XTaskQueue](https://docs.xbox.com/fr-CA/build/core-features/common/async/async-libraries/async-library-xtaskqueue.md)

[Créer une file d'attente de tâches (exemple)](https://docs.xbox.com/fr-CA/build/core-features/common/async/async-libraries/async-library-xtaskqueue-example-create-task-queue.md)

[Nettoyer une file d'attente de tâches (exemple)](https://docs.xbox.com/fr-CA/build/core-features/common/async/async-libraries/async-library-xtaskqueue-example-cleanup-task-queue.md)

[Conception de la file d'attente de tâches](https://docs.xbox.com/fr-CA/build/core-features/common/async/async-task-queue-design.md)

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


## Related topics

- [Bibliothèques XAsync pour la programmation de tâches asynchrones](https://docs.xbox.com/fr-CA/build/core-features/common/async/async-libraries/index.md)
- [Exemple de création d'une file d'attente de tâches](https://docs.xbox.com/fr-CA/build/core-features/common/async/async-libraries/async-library-xtaskqueue-example-create-task-queue.md)
- [Procédure : création d'une file d'attente de tâches manuelle](https://docs.xbox.com/fr-CA/build/core-features/common/async/async-task-queue-design-howto/creating-manual-task-queue.md)
- [Exemple de nettoyage d'une file d'attente de tâches](https://docs.xbox.com/fr-CA/build/core-features/common/async/async-libraries/async-library-xtaskqueue-example-cleanup-task-queue.md)
- [Procédure : Utiliser des événements pour contrôler la distribution manuelle d'une file d'attente](https://docs.xbox.com/fr-CA/build/core-features/common/async/async-task-queue-design-howto/control-manual-queue-dispatching.md)