Skip to main content

​
SetShapeAllocMixBufferCommand

Alloue un tampon de mixage virtuel.

​
Syntaxe

​
Paramètres

command   _Inout_
Type : SHAPE_FLOWGRAPH_COMMAND* La commande SHAPE_FLOWGRAPH_COMMAND à initialiser. virtualId   
Type : UINT32 ID virtuel du tampon de mixage, de 0 à 8191 inclusivement. Chaque tampon de mixage alloué doit avoir un ID virtuel unique. numIn   
Type : UINT32 Nombre d’entrées du tampon de mixage. Cette valeur spécifie le nombre de blocs du moteur de traitement audio matériel évolutif (SHAPE) qui écriront leur sortie dans ce tampon de mixage. numOut   
Type : UINT32 Nombre de sorties du tampon de mixage. Cette valeur spécifie le nombre de blocs SHAPE qui liront à partir de ce tampon de mixage. attenuation   
Type : SHAPE_MIXBUFFER_ATTENUATION Un membre de l’énumération SHAPE_MIXBUFFER_ATTENUATION. Cette valeur spécifie l’atténuation en dB appliquée à toutes les entrées de ce tampon de mixage.

​
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

Tous les tampons de mixage sont à canal unique (mono) et doivent être alloués avant leur utilisation. Bien qu’il y ait au total 128 tampons de mixage physiques, 8192 tampons de mixage virtuels sont disponibles. Les tampons de mixage physiques peuvent être réutilisés, mais pas les tampons de mixage virtuels. La liste d’exécution utilise des ID virtuels pour les affectations de tampons de mixage. Ce n’est que lorsqu’une commande d’allocation est exécutée qu’un tampon de mixage physique est lié à un ID virtuel donné. Les commandes subséquentes qui utilisent un ID virtuel donné seront dirigées vers le tampon de mixage physique alloué. La commande d’allocation est envoyée par le processeur SHAPE au bloc de tampons de mixage, qui effectue la liaison entre l’ID virtuel et le tampon de mixage physique. 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 l’ACP Vue d’ensemble de SHAPE shapeflowgraph
Last modified on October 6, 2026