Método IXAudio2Voice::SetOutputVoices (xaudio2.h)

Designa um novo conjunto de vozes de submixagem ou masterização para receber a saída da voz.

Sintaxe

\\HRESULT SetOutputVoices(
  [in] const XAUDIO2_VOICE_SENDS *pSendList
);

Parâmetros

[in] pSendList

Matriz de XAUDIO2_VOICE_SENDS ponteiros de estrutura para vozes de destino. Se pSendList for NULL, a voz enviará sua saída para a voz de masterização atual. Para definir a voz para não enviar sua saída em qualquer lugar, defina o membro OutputCount de XAUDIO2_VOICE_SENDS como 0. Todas as vozes em uma lista de envio devem ter a mesma taxa de amostragem de entrada, consulte Conversões de taxa de amostra XAudio2 para obter informações adicionais.

Valor retornado

Retorna S_OK se tiver êxito, caso contrário, um código de erro. Consulte Códigos de erro XAudio2 para obter descrições de códigos de erro específicos do XAudio2.

Comentários

Esse método só é válido para vozes de origem e submixagem. A masterização de vozes não pode enviar áudio para outra voz.

Depois de chamar SetOutputVoices , os níveis de envio atuais de uma voz serão substituídos por uma matriz de envio padrão. O método IXAudio2Voice::SetOutputMatrix deve ser chamado para definir uma matriz personalizada para a nova lista de envio.

É inválido chamar SetOutputVoices de dentro de um retorno de chamada (ou seja, IXAudio2EngineCallback ou IXAudio2VoiceCallback). Se SetOutputVoices for chamado dentro de um retorno de chamada, ele retornará XAUDIO2_E_INVALID_CALL.

Requisitos de plataforma

Requisitos

Confira também

IXAudio2Voice