Exemple de nettoyage d'une file d'attente de tâches

Cette rubrique fournit un exemple de nettoyage d’une file d’attente de tâches lorsqu’elle n’est plus nécessaire, afin d’éviter les fuites de ressources. Toutefois, une file d’attente de tâches ne peut pas simplement être libérée immédiatement. Elle doit d’abord être arrêtée, vidée pour garantir que tout ce qui y a été mis en file d’attente a été exécuté, puis libérée. L’appel d’arrêt peut être configuré pour attendre ou pour retourner immédiatement. Si l’appel n’attend pas, un rappel peut éventuellement être spécifié pour être notifié lorsque l’arrêt est entièrement terminé. S’il existe des ports manuels, ils doivent continuer à être distribués jusqu’à ce que la fonction de distribution retourne.

XTaskQueueTerminate(taskQueue, false, nullptr, nullptr);
bool result;
do
{
    result = XTaskQueueDispatch(taskQueue, XTaskQueuePort::Completion, INFINITE);
} while (result == true);
XTaskQueueCloseHandle(taskQueue);

Cet exemple arrête la file d’attente de tâches, mais n’attend pas, grâce au paramètre d’attente de XTaskQueueTerminate. L’appel terminate ajoute un rappel à chaque port pour détecter le moment où la file d’attente est vidée. Pour tenir compte de ce rappel et de tous les rappels mis en file d’attente précédemment, dispatch est appelé en continu jusqu’à ce qu’il retourne false.

Documentation de référence de l’API

XTaskQueue (contenu de l’API)
- Fonctions
  - xtaskqueueterminate
  - xtaskqueuedispatch

Voir aussi

Vue d’ensemble de la bibliothèque XTaskQueue Créer une file d’attente de tâches (exemple) Distribuer une file d’attente de tâches (exemple) Conception de la file d’attente de tâches XTaskQueue

Introduction

Onboarding & Access

Setup & Install

Build Your First Title

Documentation de référence de l’API

Voir aussi

​Documentation de référence de l’API

​Voir aussi

Documentation de référence de l’API

Voir aussi