> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Función SetShapeSrcCommand

> Función SetShapeSrcCommand

# Función SetShapeSrcCommand

Inicializa un comando SRC de SHAPE.

## Sintaxis

```cpp theme={null}
HRESULT SetShapeSrcCommand(  
         SHAPE_FLOWGRAPH_COMMAND* command,  
         UINT32 contextId,  
         UINT32 leftorMonoMixBuffer,  
         UINT32 rightMixBuffer  
)  
```

### Parámetros

*command*   \_Inout\_\
Tipo: SHAPE\_FLOWGRAPH\_COMMAND\*

Comando [SHAPE\_FLOWGRAPH\_COMMAND](/reference/audio/shapeflowgraph/structs/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](/build/console-features/audio/overviews/xaudio2-overview) 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](/build/console-features/audio/overviews/shape-overview)

[shapeflowgraph](/reference/audio/shapeflowgraph/shapeflowgraph_members)