Skip to main content

SetShapeAllocMixBufferCommand

Asigna un búfer de mezcla virtual.

Sintaxis

Parámetros

command   _Inout_
Tipo: SHAPE_FLOWGRAPH_COMMAND*
Comando SHAPE_FLOWGRAPH_COMMAND que se va a inicializar. virtualId   
Tipo: UINT32
Identificador virtual del búfer de mezcla, de 0 a 8191, ambos inclusive. Cada búfer de mezcla asignado debe tener un identificador virtual único. numIn   
Tipo: UINT32
Número de entradas al búfer de mezcla. Este valor especifica el número de bloques del motor de procesamiento de audio por hardware escalable (SHAPE) que enviarán su salida a este búfer de mezcla. numOut   
Tipo: UINT32
Número de salidas del búfer de mezcla. Este valor especifica el número de bloques SHAPE que leerán de este búfer de mezcla. attenuation   
Tipo: SHAPE_MIXBUFFER_ATTENUATION
Un miembro de la enumeración SHAPE_MIXBUFFER_ATTENUATION. Este valor especifica la atenuación en dB que se aplica a todas las entradas de este búfer de mezcla.

Valor devuelto

Tipo: HRESULT Si la función se ejecuta correctamente, devuelve S_OK. Si uno o varios argumentos no son válidos, la función devuelve E_INVALIDARG.

Comentarios

Todos los búferes de mezcla son de un solo canal (mono) y deben asignarse antes de su uso. Aunque hay un total de 128 búferes de mezcla físicos, hay 8192 búferes de mezcla virtuales disponibles. Los búferes de mezcla físicos se pueden reutilizar, pero los búferes de mezcla virtuales no. La lista de ejecución usa identificadores virtuales para las asignaciones de búferes de mezcla. Solo cuando se ejecuta un comando de asignación se enlaza un búfer de mezcla físico a un identificador virtual determinado. Los comandos posteriores que usen un identificador virtual determinado se dirigirán al búfer de mezcla físico asignado. El comando de asignación se envía desde el procesador SHAPE al bloque de búferes de mezcla, que realiza el enlace del identificador virtual al búfer de mezcla físico. Muchos títulos no implementan grafos de flujo directamente. XAudio2 y el middleware de audio implementan los componentes de SHAPE de forma implícita. Sin embargo, construir grafos de flujo proporciona la mayor flexibilidad y acceso a las capacidades de aceleración de audio de la consola XBOX One.

Requisitos

Encabezado: shapeflowgraph.h Plataformas compatibles: consolas de la familia XBOX One y consolas XBOX Series

Consulte también

Información general sobre ACP Información general de SHAPE shapeflowgraph
Última modificación el 28 de agosto de 2026