Skip to main content

Función SetShapeSrcCommand

Inicializa un comando SRC de SHAPE.

Sintaxis

Parámetros

command   _Inout_
Tipo: SHAPE_FLOWGRAPH_COMMAND*
Comando SHAPE_FLOWGRAPH_COMMAND que se va a inicializar. contextId   
Tipo: UINT32
Identificador (índice) del contexto SRC al que hará referencia este comando. leftorMonoMixBuffer   
Tipo: UINT32
Identificador del búfer de mezcla de entrada. rightMixBuffer   
Tipo: UINT32
Identificador del búfer de mezcla de salida.

Valor devuelto

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

Comentarios

Puede enviar grafos de flujo para que se procesen como persistentes o no persistentes. Los grafos de flujo persistentes se procesan y luego permanecen residentes para repetir su procesamiento en el fotograma siguiente, después de que los punteros de lectura y escritura hayan avanzado y de que se haya actualizado otra información de contexto. Puede usar grafos de flujo persistentes para cualquiera de los siguientes escenarios.
  • Grafos de flujo muy complejos que requieren una cantidad significativa de procesamiento de CPU para reensamblar cada fotograma.
  • Grafos de flujo muy estáticos con el mismo número y configuración de voces durante un período de tiempo prolongado.
Use grafos de flujo no persistentes para cualquiera de los siguientes escenarios.
  • Las topologías de voces cambian con frecuencia.
  • La cadencia de procesamiento del motor de software de audio de su título está desacoplada del hardware SHAPE, es decir, no es un múltiplo de 2,667 ms.
  • Quiere ejecutar el procesamiento de audio más rápido que en tiempo real, enviando grafos para que se consuman tan pronto como estén disponibles.
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 de SHAPE shapeflowgraph
Última modificación el 28 de agosto de 2026