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.
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 de XTaskQueueModèle de programmation asynchrone
Conception de la file d’attente de tâches asynchrones
