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.
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.
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 :
- XTaskQueueSubmitCallback
- XTaskQueueSubmitDelayedCallback
- XTaskQueueDispatch, à condition que 0 soit passé pour timeoutInMs
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 SeriesVoir aussi
Membres XTaskQueueModèle de programmation asynchrone
Conception de la file d’attente de tâches asynchrones
