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 de 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 des ports. En général, 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 le rappel est annulé. Si un rappel XTaskQueueCallback est appelé et que canceled est défini sur true, la file d’attente de tâches de ce rappel a été arrêtée par un appel à XTaskQueueTerminate et 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 de XTaskQueueModèle de programmation asynchrone
Conception de la file d’attente de tâches asynchrones