Skip to main content

​
XApuEnqueueCommand

Soumet une seule commande à la file d’attente des commandes XAPU.

​
Syntaxe

​
Paramètres

handle   _In_
Type : XApuHandle Handle retourné par l’appel à XApuConnect. command   _In_
Type : XApuCommandId* Commande à soumettre à la file d’attente d’entrée du XAPU. totalCommandCount   _Out_opt_
Type : uint32_t* Nombre total de commandes, retourné.

​
Valeur de retour

Type : HRESULT Retourne S_OK en cas de réussite; sinon, retourne un code d’erreur.

​
Remarques

Cet appel est rapide, car il n’alloue pas de ressources et ne traite pas de données; il envoie simplement la commande au serveur matériel. Cet appel retourne XAPU_E_QUEUE_FULL s’il y a XApuConnectInputParameters::maxQueuedCommandsPerStream commandes en cours de traitement. Pour éviter cette erreur, l’appelant doit récupérer un ou plusieurs résultats au moyen de XApuDequeueResult. Cet appel est thread-safe, c’est-à-dire qu’il est possible de soumettre des commandes à partir de plusieurs threads; toutefois, l’appeler à partir de plusieurs threads n’offre aucun avantage en matière de performances. Cet appel prend également un pointeur vers uint32_t pour retourner totalCommandCount pour la session actuelle. Ce nombre représente le total des commandes soumises avec succès depuis le début de la session et après l’appel à XApuConnect. Ce nombre ne revient pas à zéro. Si le serveur matériel est dans un état incorrect, XApuEnqueueCommand retourne le code d’erreur XAPU_E_DEVICE_FATAL_ERROR. Dans ce cas, tous les clients XAPU doivent être déconnectés puis reconnectés. Si cette méthode échoue, un code d’erreur descriptif est retourné. Le tableau suivant associe chaque XApuCommandType au type de struct qui doit être transmis à XApuEnqueueCommand :

​
Configuration requise

En-tête : xapu.h Bibliothèque : xapu.lib Plateformes prises en charge : XBOX Series X|S

​
Voir aussi

XAPU
Last modified on October 6, 2026