Skip to main content

XTaskQueueSubmitDelayedCallback

Soumet un rappel à la file d’attente pour le port donné.

Syntaxe

Paramètres

queue   _In_
Type : XTaskQueueHandle
File d’attente à laquelle soumettre le rappel. port   _In_
Type : XTaskQueuePort
Port auquel soumettre le rappel. Les rappels peuvent être affectés aux ports de travail ou d’achèvement. delayMs   _In_
Type : uint32_t
Nombre de millisecondes à attendre avant de soumettre le rappel à la file d’attente.
Un rappel peut être soumis afin d’être ajouté à la file d’attente à un moment ultérieur. Si delayMs est différent de zéro, le rappel est placé dans une liste en attente et un minuteur est initialisé avec le temps d’attente le plus proche. Lorsque ce délai est écoulé, le rappel correspondant est placé dans la liste d’exécution. La file d’attente déclenche un XTaskQueueMonitorCallback et, si la file d’attente s’exécute dans un mode de distribution de pool de threads, un travail de pool de threads est soumis.
callbackContext   _In_opt_
Type : void*
Pointeur de contexte facultatif qui sera passé au rappel. callback   _In_
Type : XTaskQueueCallback*
Pointeur vers la fonction de rappel.

Valeur de retour

Type : HRESULT Code de réussite ou d’erreur HRESULT.

Remarques

Ce rappel sera ajouté à la file d’attente après delayMs millisecondes. alerte Remarque sur les performances :
L’ajout d’un élément à une file d’attente doit se faire sans verrou ni attente afin de satisfaire aux exigences de performances du code en amont. Les API suivantes sont sans verrou :
L’exemple suivant permet de soumettre des rappels ultérieurement à l’aide de la fonction XTaskQueueSubmitDelayedCallback. C’est un excellent moyen de réessayer un appel ayant échoué après un court délai ; cela peut également servir de minuteur peu coûteux pour des événements périodiques.
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 Series

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