Skip to main content

XTaskQueueSetCurrentProcessTaskQueue

Définit la file d’attente de tâches donnée comme file d’attente de tâches à l’échelle du processus.

Syntaxe

Paramètres

queue   _In_
Type : XTaskQueueHandle
File d’attente à configurer comme file d’attente de tâches par défaut du processus.

Valeur de retour

Type : void

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.
La file d’attente peut être définie sur nullptr, auquel cas XTaskQueueGetCurrentProcessTaskQueue retournera également nullptr. Le handle de la file d’attente fournie sera dupliqué, et le handle de toute file d’attente de tâches de processus existante sera fermé. L’exemple suivant remplace la file d’attente de tâches de processus par défaut. Cette file d’attente de tâches utilise le pool de threads pour la distribution du travail et des achèvements. Les API du Microsoft Game Development Kit (GDK) qui acceptent des paramètres de file d’attente de tâches acceptent toutes nullptr et y substituent la file d’attente de tâches du processus. La file d’attente de tâches du processus peut également être définie sur nullptr, auquel cas les API du Microsoft Game Development Kit (GDK) qui exigent un paramètre de file d’attente de tâches échoueront avec E_NO_TASK_QUEUE si une valeur nulle est fournie. Cela permet aux API du Microsoft Game Development Kit (GDK) de fonctionner avec des valeurs par défaut tout en permettant un contrôle étroit des handles de file d’attente de tâches au besoin.

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