XTaskQueueCallback
Rappel appelé par la file d’attente de tâches.Syntaxe
Paramètres
context _In_opt_Type : void* Facultatif. Pointeur de contexte transmis lors de l’appel à XTaskQueueSubmitCallback. canceled _In_
Type : bool Si la valeur est true, le rappel est annulé parce que la file d’attente de tâches est en cours d’arrêt.
Valeur de retour
Type : voidRemarques
Le rappelXTaskQueueCallback est implémenté pour effectuer du travail sur une file d’attente de tâches. Les rappels peuvent être soumis au port de travail ou au port d’achèvement d’une file d’attente de tâches en appelant XTaskQueueSubmitCallback ou XTaskQueueSubmitDelayedCallback. Le port de travail et le port d’achèvement d’une file d’attente de tâches peuvent avoir des modes de distribution indépendants, et les rappels XTaskQueueCallback peuvent être soumis à l’un ou l’autre port. En règle générale, un rappel soumis à un port de travail soumet à son tour un rappel correspondant au port d’achèvement une fois son travail terminé.
Le paramètre canceled a pour but de garantir que toutes les ressources allouées par un rappel peuvent être correctement libérées si un rappel est annulé. Si un rappel XTaskQueueCallback est appelé avec canceled défini sur true, cela signifie que la file d’attente de tâches de ce rappel a été arrêtée par un appel à XTaskQueueTerminate et que le rappel a été annulé. Le rappel doit libérer toutes les ressources allouées, y compris la mémoire allouée dans context, et n’effectuer aucun autre travail.
Pour obtenir un exemple, consultez Soumission de rappels.
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 SeriesVoir aussi
Membres XTaskQueueModèle de programmation asynchrone
Conception de la file d’attente de tâches asynchrones