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 pour le processus.

Valeur de retour

Type : void

Remarques

Il n’est pas sûr d’appeler cette fonction sur un thread urgent. Pour plus d’informations, consultez Threads urgents.
La file d’attente peut être définie sur nullptr, auquel cas XTaskQueueGetCurrentProcessTaskQueue retournera également nullptr. Le handle de la file d’attente fournie est dupliqué et le handle de toute file d’attente de tâches du processus existante est fermé. L’exemple suivant remplace la file d’attente de tâches du 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 prennent des paramètres de file d’attente de tâches acceptent toutes nullptr et lui 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 nécessitent un paramètre de file d’attente de tâches échouent avec l’erreur E_NO_TASK_QUEUE si null a été fourni. 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 si nécessaire.

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 XTaskQueue
Modèle de programmation asynchrone
Conception de la file d’attente de tâches asynchrones
Last modified on October 6, 2026