Skip to main content

​
SetShapeAllocMixBufferCommand

Alloue une mémoire tampon de mixage virtuelle.

​
Syntaxe

​
Paramètres

command   _Inout_
Type : SHAPE_FLOWGRAPH_COMMAND* La commande SHAPE_FLOWGRAPH_COMMAND à initialiser. virtualId   
Type : UINT32 ID virtuel de la mémoire tampon de mixage, compris entre 0 et 8191 inclus. Chaque mémoire tampon de mixage allouée doit avoir un ID virtuel unique. numIn   
Type : UINT32 Nombre d’entrées de la mémoire tampon de mixage. Cette valeur indique le nombre de blocs SHAPE (Scalable Hardware Audio Processing Engine) qui écriront leur sortie dans cette mémoire tampon de mixage. numOut   
Type : UINT32 Nombre de sorties de la mémoire tampon de mixage. Cette valeur indique le nombre de blocs SHAPE qui liront depuis cette mémoire tampon de mixage. attenuation   
Type : SHAPE_MIXBUFFER_ATTENUATION Un membre de l’énumération SHAPE_MIXBUFFER_ATTENUATION. Cette valeur indique l’atténuation en dB appliquée à toutes les entrées de cette mémoire 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

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