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

# XTaskQueueCallback

> XTaskQueueCallback

# XTaskQueueCallback

Rappel appelé par la file d'attente de tâches.

## Syntaxe

```cpp theme={null}



void XTaskQueueCallback(  
         void* context,  
         bool canceled  
)  
```

### Paramètres

*context*   \_In\_opt\_\
Type : void\*

Facultatif. Pointeur de contexte transmis lors de l'appel à [XTaskQueueSubmitCallback](/fr/reference/system/xtaskqueue/functions/xtaskqueuesubmitcallback).

*canceled*   \_In\_\
Type : bool

Si la valeur est true, le rappel est annulé parce que la file d'attente de tâches est en cours d'arrêt.

### Valeur de retour

Type : void

## Remarques

Le rappel `XTaskQueueCallback` est implémenté pour effectuer du travail sur une file d'attente de tâches. Les rappels peuvent être soumis au port de travail ou au port d'achèvement d'une file d'attente de tâches en appelant [XTaskQueueSubmitCallback](/fr/reference/system/xtaskqueue/functions/xtaskqueuesubmitcallback) ou [XTaskQueueSubmitDelayedCallback](/fr/reference/system/xtaskqueue/functions/xtaskqueuesubmitdelayedcallback). Le port de travail et le port d'achèvement d'une file d'attente de tâches peuvent avoir des modes de distribution indépendants, et les rappels `XTaskQueueCallback` peuvent être soumis à l'un ou l'autre port. En règle générale, un rappel soumis à un port de travail soumet à son tour un rappel correspondant au port d'achèvement une fois son travail terminé.

Le paramètre `canceled` a pour but de garantir que toutes les ressources allouées par un rappel peuvent être correctement libérées si un rappel est annulé. Si un rappel `XTaskQueueCallback` est appelé avec `canceled` défini sur true, cela signifie que la file d'attente de tâches de ce rappel a été arrêtée par un appel à [XTaskQueueTerminate](/fr/reference/system/xtaskqueue/functions/xtaskqueueterminate) et que le rappel a été annulé. Le rappel doit libérer toutes les ressources allouées, y compris la mémoire allouée dans `context`, et n'effectuer aucun autre travail.

Pour obtenir un exemple, consultez [Soumission de rappels](/fr/build/core-features/common/async/async-task-queue-design-howto/submitting-callbacks).

## Configuration requise

**En-tête :** XTaskQueue.h

**Bibliothèque :** xgameruntime.lib

**Plateformes prises en charge :** Windows, consoles de la famille XBOX One et consoles XBOX Series

## Voir aussi

[Membres XTaskQueue](/fr/reference/system/xtaskqueue/xtaskqueue_members)\
[Modèle de programmation asynchrone](/fr/build/core-features/common/async/async-programming-model)\
[Conception de la file d'attente de tâches asynchrones](/fr/build/core-features/common/async/async-task-queue-design)


## Related topics

- [XTaskQueueCallback](/reference/system/xtaskqueue/functions/xtaskqueuecallback.md)
- [XTaskQueueSubmitCallback](/reference/system/xtaskqueue/functions/xtaskqueuesubmitcallback.md)
- [XTaskQueueSubmitDelayedCallback](/reference/system/xtaskqueue/functions/xtaskqueuesubmitdelayedcallback.md)
- [XTaskQueue](/reference/system/xtaskqueue/xtaskqueue_members.md)
- [Async task queue design](/build/core-features/common/async/async-task-queue-design.md)