XTaskQueueTerminate
Termine une file d’attente de tâches en annulant tous les éléments en attente et en empêchant la mise en file d’attente de nouveaux éléments.Syntaxe
Paramètres
queue _In_Type : XTaskQueueHandle File d’attente à terminer. wait _In_
Type : bool True pour attendre la fin de la terminaison. callbackContext _In_opt_
Type : void* Pointeur de contexte facultatif à passer au rappel. callback _In_opt_
Type : XTaskQueueTerminatedCallback* Rappel facultatif qui sera appelé lorsque la file d’attente aura été terminé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.
- Tous les rappels des deux ports sont appelés avec leur paramètre canceled défini sur true.
- Tous les rappels en attente sur le port de travail sont distribués. La soumission de nouveaux rappels au port de travail échoue avec E_ABORT.
- Tous les rappels en attente sur le port d’achèvement sont distribués. La soumission de nouveaux rappels au port d’achèvement échoue avec E_ABORT.
- XTaskQueueTerminate ne ferme pas le handle de la file d’attente. Après la terminaison, vous devez toujours appeler XTaskQueueCloseHandle.
- Si vous appelez XTaskQueueTerminate sur un thread qui traite les rappels de la file d’attente en appelant XTaskQueueDispatch, ne passez pas true pour le paramètre wait, sinon votre code risque de se retrouver en interblocage.
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 SeriesDocumentation conceptuelle
Voir aussi
Membres de XTaskQueueModèle de programmation asynchrone
Conception de la file d’attente de tâches asynchrones
