Pular para o conteúdo principal

Função SetShapeSrcCommand

Inicializa um comando SRC do SHAPE.

Sintaxe

Parâmetros

command   _Inout_
Tipo: SHAPE_FLOWGRAPH_COMMAND*
Comando 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 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 shapeflowgraph
Última modificação em 6 de outubro de 2026