Skip to main content

​
Fonction SetShapeSrcCommand

Initialise une commande SRC SHAPE.

​
Syntaxe

​
Paramètres

command   _Inout_
Type : SHAPE_FLOWGRAPH_COMMAND* Commande SHAPE_FLOWGRAPH_COMMAND à initialiser. contextId   
Type : UINT32 ID (index) du contexte SRC auquel cette commande fera référence. leftorMonoMixBuffer   
Type : UINT32 ID du tampon de mixage d’entrée. rightMixBuffer   
Type : UINT32 ID du tampon de mixage de sortie.

​
Valeur de retour

Type : HRESULT Si la fonction réussit, elle retourne S_OK. Si un ou plusieurs des arguments ne sont pas valides, la fonction retourne E_INVALIDARG.

​
Remarques

Vous pouvez soumettre des graphes de flux à traiter de façon persistante ou non persistante. Les graphes de flux persistants sont traités, puis restent résidents pour répéter leur traitement dans la trame suivante, une fois que les pointeurs de lecture et d’écriture ont avancé et que les autres informations de contexte ont été mises à jour. Vous pouvez utiliser des graphes de flux persistants pour l’un ou l’autre des scénarios suivants.
  • Graphes de flux très complexes qui nécessitent une quantité importante de traitement processeur pour réassembler chaque trame.
  • Graphes de flux très statiques comportant le même nombre et la même configuration de voix pendant une période prolongée.
Utilisez des graphes de flux non persistants pour l’un des scénarios suivants.
  • Les topologies de voix changent fréquemment.
  • La cadence de traitement du moteur audio logiciel de votre titre est dissociée du matériel SHAPE et n’est pas un multiple de 2,667 ms.
  • Vous souhaitez exécuter le traitement audio plus rapidement qu’en temps réel, en soumettant des graphes à consommer dès qu’ils sont disponibles.
De nombreux titres n’implémentent pas directement de graphes de flux. XAudio2 et les intergiciels audio implémentent implicitement les composants SHAPE. Cependant, la construction de graphes de flux offre la plus grande flexibilité et le meilleur accès aux capacités d’accélération audio de la console XBOX One.

​
Configuration requise

En-tête : shapeflowgraph.h Plateformes prises en charge : consoles de la famille XBOX One et consoles XBOX Series

​
Voir aussi

Vue d’ensemble de SHAPE shapeflowgraph
Last modified on October 6, 2026