Skip to main content

XTaskQueueGetPort

Retourne le handle de port de file d’attente de tâches pour le port donné.

Syntaxe

Paramètres

queue   _In_
Type : XTaskQueueHandle
File d’attente de tâches à partir de laquelle obtenir le port. port   _In_
Type : XTaskQueuePort
Port à obtenir. portHandle   _Out_
Type : XTaskQueuePortHandle*
Handle de port de file d’attente de tâches pour le port donné.

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.
Les handles de port de file d’attente de tâches appartiennent à la file d’attente de tâches et n’ont pas besoin d’être fermés. Ils sont utilisés lors de la création de files d’attente de tâches composites. L’exemple suivant crée une file d’attente composite dont les ports de travail et d’achèvement utilisent tous deux le port de travail de la file d’attente d’origine. Une file d’attente de tâches composite est une file d’attente de tâches composée d’éléments d’autres files d’attente. Les files d’attente de tâches composites sont utiles lorsqu’une tâche asynchrone doit en appeler une autre et que l’achèvement de cette tâche est une étape intermédiaire qui ne doit pas gaspiller de cycles sur le thread d’achèvement.
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

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