Skip to main content

XTaskQueueRegisterWaiter

Inscrit un handle d’attente auprès d’une file d’attente de tâches.

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. waitHandle   _In_
Type : HANDLE
Handle à surveiller.
Il s’agit du handle d’attente qui, lorsqu’il est signalé, provoque l’invocation du rappel. Le handle d’attente est généralement un événement à réinitialisation automatique ou manuelle. Si le handle d’attente est à réinitialisation manuelle, le rappel sera invoqué de manière répétée tant que l’événement est signalé. Si ce n’est pas ce que vous souhaitez, réinitialisez l’événement dans le rappel ou désinscrivez le rappel d’attente.
callbackContext   _In_opt_
Type : void*
Pointeur de contexte facultatif qui sera passé au rappel. callback   _In_
Type : XTaskQueueCallback*
Pointeur vers la fonction de rappel. token   _Out_
Type : XTaskQueueRegistrationToken*
Jeton d’inscription. Il peut être passé à XTaskQueueUnregisterWaiter pour désinscrire l’attente.

Valeur de retour

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

Remarques

Il n’est pas sûr d’appeler cette fonction sur un thread urgent. Pour plus d’informations, consultez Threads urgents.
Lorsque le handle d’attente est satisfait, la file d’attente de tâches invoque le rappel donné. Cela offre un moyen efficace d’ajouter des éléments à une file d’attente de tâches en réponse au signalement de handles. L’exemple suivant inscrit un handle de noyau Win32 auprès d’une file d’attente de tâches. Votre rappel sera soumis à la file d’attente lorsque le handle sera signalé. Normalement, vous créez un événement à réinitialisation automatique à utiliser pour la signalisation. Si le handle n’est pas à réinitialisation automatique, un nouveau rappel sera soumis à la fin du rappel en cours tant que le handle est signalé.

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

Documentation conceptuelle

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