Skip to main content

​
SetShapeEqCompCommand

Initialise une commande EQ/Comp SHAPE.

​
Syntaxe

​
Paramètres

command   _Inout_
Type : SHAPE_FLOWGRAPH_COMMAND* La commande SHAPE_FLOWGRAPH_COMMAND à initialiser. contextId   
Type : UINT32 ID du contexte EQ/Comp (index) auquel cette commande fera référence. inputMixBuffer   
Type : UINT32 ID de la mémoire tampon de mixage d’entrée. sidechainMixBuffer   
Type : UINT32 Mémoire tampon de mixage de sidechain. Ce paramètre est utilisé uniquement pour les sidechains externes et est ignoré pour les sidechains normales et internes. Pour plus d’informations, consultez SHAPE_EQCOMP_SIDECHAIN_MODE. outputMixBuffer   
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

Le rôle du compresseur est de limiter la plage dynamique du signal. Pour ce faire, il surveille le niveau d’entrée et crée une valeur de gain dynamique. Cette valeur de gain est ensuite utilisée comme multiplicateur du signal et le met à l’échelle de manière appropriée en fonction du niveau actuel du signal d’entrée. En d’autres termes, il s’agit d’un contrôle automatique du volume, qui surveille en permanence le signal d’entrée et s’ajuste en permanence. Le compresseur n’agit que sur les signaux supérieurs à un seuil spécifique. Si le signal est inférieur au seuil, il passe sans modification. Le seuil est défini par l’application dans les données de contexte EQComp. Le contexte comporte un contrôle programmable permettant d’effectuer une compression ou une expansion. Le compresseur modifie les données sonores selon un paramètre de ratio. Celui-ci indique l’atténuation à appliquer au signal entrant s’il dépasse le seuil. Le ratio est exactement cela : le rapport entre le niveau entrant et le niveau sortant. Avec un ratio de 2:1, chaque tranche de 2 dB au-dessus du seuil produit 1 dB en sortie du compresseur au-dessus du niveau de seuil. Avec un ratio de 1:1, le compresseur est pratiquement désactivé. Le ratio est défini par l’application dans les données de contexte.

​
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