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 du contexte SRC (index) auquel cette commande fera référence. leftorMonoMixBuffer   
Type : UINT32 ID de la mémoire tampon de mixage d’entrée. rightMixBuffer   
Type : UINT32 ID de la mémoire tampon de mixage de sortie.

​
Valeur de retour

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

​
Remarques

Vous pouvez soumettre des flowgraphs à traiter de manière persistante ou non persistante. Les flowgraphs persistants effectuent leur traitement puis restent résidents pour le répéter à la trame suivante, une fois les pointeurs de lecture et d’écriture avancés et les autres informations de contexte mises à jour. Vous pouvez utiliser des flowgraphs persistants pour l’un des scénarios suivants.
  • Flowgraphs très complexes qui nécessitent une quantité importante de traitement processeur pour être réassemblés à chaque trame.
  • Flowgraphs très statiques avec le même nombre et la même configuration de voix sur une période prolongée.
Utilisez des flowgraphs non persistants pour l’un des scénarios suivants.
  • Les topologies de voix changent fréquemment.
  • La cadence de traitement du moteur logiciel audio de votre titre est découplé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 flowgraphs. XAudio2 et les intergiciels audio implémentent implicitement les composants SHAPE. Toutefois, la construction de flowgraphs offre la plus grande flexibilité et donne accès aux fonctionnalité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