Skip to main content

​
XApuConnect

Établit une connexion et alloue les ressources nécessaires pour une unité de traitement audio (XAPU).

​
Syntaxe

​
Paramètres

params   _In_
Type : XApuConnectInputParameters* Paramètres passés à XApuConnect pour allouer les ressources. data   _Out_
Type : XApuConnectOutputParameters* Paramètres retournés par XApuConnect. handle   _Outptr_
Type : XApuHandle* Pointeur vers le handle XAPU retourné. Ce handle permet d’indiquer quelle instance XAPU manipuler lors de l’appel d’autres API XAPU.

​
Valeur renvoyée

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

​
Remarques

L’appelant doit spécifier un XApuProcessType que le client XAPU doit exécuter. Une instance de XAPU ne peut travailler qu’avec un seul type de processus pendant sa durée de vie. Pour exécuter deux processus différents ou plus, deux instances XAPU ou plus doivent être instanciées. Dans XApuConnectInputParameters, l’appelant doit spécifier les éléments suivants :
  • Nombre maximal de flux que le XAPU est censé traiter simultanément.
  • Nombre maximal de commandes en file d’attente pour chaque flux.
  • Allocation de mémoire totale requise pour toutes les commandes et tous les flux. Cela inclut les allocations totales pour les données d’entrée, de sortie et de traitement, sur le nombre maximal de flux multiplié par le nombre de commandes en file d’attente par flux.
Si l’appel réussit, le paramètre XApuConnectOutputParameters::baseData pointe vers un bloc de mémoire que l’appelant doit utiliser pour passer les données d’entrée et récupérer les données de sortie des flux. Il appartient à l’appelant de partitionner et de recycler ce bloc de mémoire. L’allocation est libérée lors de l’appel à XApuDisconnect. XApuConnectOutputParameters::resultReadyEvent contient un handle d’événement Win32 lorsque XApuConnectOptions::EnableResultReadyEvent est défini. Ce handle est fermé lors d’un appel à XApuDisconnect. Ce handle est fermé lors d’un appel à XApuDisconnect. Il n’est pas recommandé d’appeler fréquemment XapuConnect et XApuDisconnect pour démarrer et arrêter des flux, car ces appels sont coûteux en temps et peuvent également entraîner des pertes de ressources dues à la fragmentation de la mémoire. XapuConnect doit plutôt être appelé une seule fois lors de l’initialisation de la session de streaming, puis XApuCommandType::Activate et XApuCommandType::Deactivate doivent être utilisés pour démarrer et arrêter des flux pendant le streaming. À la fin de la session de streaming, XApuDisconnect doit être appelé. Cela s’applique à tous les clients XAPU.

​
Configuration requise

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

​
Documentation conceptuelle

​
Voir aussi

XAPU
XApuDecodeConvertCommand
XApuDequeueResult
XApuEnqueueCommand
XApuGetResultCount
Last modified on October 6, 2026