Skip to main content

XTaskQueueCreate

Crée une file d’attente de tâches, qui peut être utilisée pour mettre en file d’attente et distribuer des appels.

Syntaxe

Paramètres

workDispatchMode   _In_
Type : XTaskQueueDispatchMode
Mode de distribution du port « travail » de la file d’attente. completionDispatchMode   _In_
Type : XTaskQueueDispatchMode
Mode de distribution du port « achèvement » de la file d’attente. queue   _Out_
Type : XTaskQueueHandle*
File d’attente nouvellement créée.

Valeur de retour

Type : HRESULT Code de réussite ou d’erreur HRESULT.

Remarques

Cette fonction ne peut pas être appelée en toute sécurité sur un thread sensible au temps. Pour plus d’informations, consultez Threads sensibles au temps.
Les files d’attente de tâches sont des objets avec décompte de références. Libérez la référence en appelant XTaskQueueCloseHandle. Une file d’attente de tâches possède un port de travail et un port d’achèvement, et des tâches peuvent être mises en file d’attente sur l’un ou l’autre port. Chaque port peut être configuré avec son propre mode de distribution. Dans la plupart des scénarios, vous créez une file d’attente de tâches avec l’API XTaskQueueCreate. Toutefois, si vous enchaînez plusieurs appels asynchrones, il est parfois utile de créer une file d’attente composite au moyen de XTaskQueueCreateComposite. Prenons l’exemple d’une API dont l’implémentation doit appeler une autre API qui utilise une file d’attente de tâches. Vous voudrez peut-être rediriger le rappel d’achèvement de l’API afin qu’il ne monopolise pas le thread d’achèvement de l’appelant. Dans ce cas, vous pouvez créer une file d’attente de tâches composite dont les ports de travail et d’achèvement sont construits à partir du port de travail d’une autre file d’attente. L’exemple suivant crée une file d’attente de tâches qui distribue les rappels de travail et d’achèvement sur le pool de threads du système.
SubmitCallback est une fonction d’assistance définie dans l’exemple de code de la fonction XTaskQueueSubmitCallback.
L’exemple suivant crée une file d’attente de tâches pompée manuellement. Il crée deux threads STL qui distribuent les appels pour les ports de travail et d’achèvement.
SubmitCallback est une fonction d’assistance définie dans l’exemple de code de la fonction XTaskQueueSubmitCallback.

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

Documentation conceptuelle

Voir aussi

Membres de XTaskQueue
Modèle de programmation asynchrone
Conception de la file d’attente de tâches asynchrones
Last modified on October 6, 2026