Skip to main content

​
XApuEnqueueCommand

Soumet une commande unique à 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 XAPU. totalCommandCount   _Out_opt_
Type : uint32_t* Nombre total de commandes, retourné.

​
Valeur renvoyée

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 si XApuConnectInputParameters::maxQueuedCommandsPerStream commandes sont en cours de traitement. Pour éviter cette erreur, l’appelant doit récupérer un ou plusieurs résultats via XApuDequeueResult. Cet appel est thread-safe, c’est-à-dire qu’il est possible de soumettre des commandes depuis plusieurs threads ; toutefois, l’appeler depuis plusieurs threads n’apporte aucun gain de performances. Cet appel accepte également un pointeur vers un uint32_t pour retourner le totalCommandCount de la session actuelle. Ce nombre représente le total des commandes soumises avec succès depuis le début de la session, après l’appel à XApuConnect. Ce nombre ne revient jamais à 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 structure à passer à 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