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 transmis à 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 sert à indiquer l’instance XAPU à manipuler lors de l’appel d’autres API XAPU.

​
Valeur de retour

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 XAPU peut fonctionner avec un seul type de traitement pendant sa durée de vie. Pour effectuer deux traitements différents ou plus, il faut instancier deux instances XAPU ou plus. Dans XApuConnectInputParameters, l’appelant doit spécifier les éléments suivants :
  • Nombre maximal de flux que le XAPU doit traiter simultanément.
  • Nombre maximal de commandes en file d’attente pour chaque flux.
  • Allocation de mémoire totale requise pour l’ensemble des commandes et des flux. Cela comprend les allocations totales pour les données d’entrée, de sortie et de traitement, pour 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 transmettre les données d’entrée et récupérer les données de sortie des flux. Il revient à 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 XapuConnect et XApuDisconnect fréquemment pour démarrer et arrêter des flux, car ces appels prennent du temps et peuvent également entraîner des pertes de ressources en raison de la fragmentation de la mémoire. Appelez plutôt XapuConnect une seule fois lors de l’initialisation de la session de diffusion en continu, puis utilisez XApuCommandType::Activate et XApuCommandType::Deactivate pour démarrer et arrêter les flux pendant la diffusion. À la fin de la session de diffusion en continu, appelez XApuDisconnect. 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