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 d’attente avant de soumettre le rappel à la file d’attente.
Un rappel peut être soumis pour être ajouté à la file d’attente à un moment ultérieur. Si delayMs n’est pas nul, le rappel est placé dans une liste en attente et un minuteur est initialisé avec le prochain délai d’attente le plus proche. Lorsque le délai est écoulé, le rappel ayant le délai suivant 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 par pool de threads, du travail est soumis au pool de threads.
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. alert 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 dans le futur à 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 aussi 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 de XTaskQueue
Modèle de programmation asynchrone
Conception de la file d’attente de tâches asynchrones
Last modified on October 6, 2026