> ## 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.

# Função SetShapeSrcCommand

> Função SetShapeSrcCommand

# Função SetShapeSrcCommand

Inicializa um comando SRC do SHAPE.

## Sintaxe

```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](/pt-BR/reference/audio/shapeflowgraph/structs/shape_flowgraph_command) a ser inicializado.

*contextId*   \
Tipo: UINT32

ID do contexto SRC (índice) que esse comando referenciará.

*leftorMonoMixBuffer*   \
Tipo: UINT32

ID do buffer de mixagem de entrada.

*rightMixBuffer*   \
Tipo: UINT32

ID do buffer de mixagem de saída.

### Valor retornado

Tipo: HRESULT

Se a função for bem-sucedida, ela retornará `S_OK`. Se um ou mais argumentos forem inválidos, a função retornará `E_INVALIDARG`.

## Comentários

Você pode enviar flowgraphs para serem processados como persistentes ou não persistentes. Os flowgraphs persistentes são processados e permanecem residentes para repetir o processamento no próximo quadro, depois que os ponteiros de leitura e gravação avançam e depois que outras informações de contexto são atualizadas. Você pode usar flowgraphs persistentes para qualquer um dos cenários a seguir.

* **Flowgraphs altamente complexos** que exigem uma quantidade significativa de processamento de CPU para remontar cada quadro.
* **Flowgraphs altamente estáticos** com o mesmo número e a mesma configuração de vozes por um período prolongado.

Use flowgraphs não persistentes para qualquer um dos cenários a seguir.

* As topologias de voz mudam com frequência.
* A cadência de processamento do mecanismo de software de áudio do seu título está desvinculada do hardware SHAPE, não sendo um múltiplo de 2,667 ms.
* Você deseja executar o processamento de áudio mais rápido que em tempo real, enviando grafos para serem consumidos assim que estiverem disponíveis.

Muitos títulos não implementam flowgraphs diretamente. O [XAudio2](/pt-BR/build/console-features/audio/overviews/xaudio2-overview) e o middleware de áudio implementam componentes do SHAPE implicitamente. No entanto, construir flowgraphs oferece a maior flexibilidade e acesso aos recursos de aceleração de áudio do console XBOX One.

## Requisitos

**Cabeçalho:** shapeflowgraph.h

**Plataformas com suporte:** consoles da família XBOX One e consoles XBOX Series

## Confira também

[Visão geral do SHAPE](/pt-BR/build/console-features/audio/overviews/shape-overview)

[shapeflowgraph](/pt-BR/reference/audio/shapeflowgraph/shapeflowgraph_members)


## Related topics

- [ShapeFlowGraph](/pt-BR/reference/audio/shapeflowgraph/shapeflowgraph_members.md)
- [SetShapeSrcCommand](/pt-BR/reference/audio/shapesrccontext/functions/shapesrccontext_setshapesrccommand.md)
- [SHAPE_SRC_COMMAND_TYPE](/pt-BR/reference/audio/shapesrccontext/enums/shape_src_command_type.md)
- [ShapeSrcContext](/pt-BR/reference/audio/shapesrccontext/shapesrccontext_members.md)
- [GetShapeSrcCommandType](/pt-BR/reference/audio/shapesrccontext/functions/getshapesrccommandtype.md)