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

  • Artículo

Designa un nuevo conjunto de voces de submezcla o maestro para recibir la salida de la voz.

Sintaxis

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

Parámetros

[in] pSendList

Matriz de XAUDIO2_VOICE_SENDS punteros de estructura a voces de destino. Si pSendList es NULL, la voz enviará su salida a la voz de maestro actual. Para establecer la voz en que no envíe su salida en ningún lugar, establezca el miembro OutputCount de XAUDIO2_VOICE_SENDS en 0. Todas las voces de una lista de envío deben tener la misma frecuencia de muestreo de entrada, consulte Conversiones de frecuencia de muestreo XAudio2 para obtener información adicional.

Valor devuelto

Devuelve S_OK si se ejecuta correctamente, de lo contrario, un código de error. Consulte Códigos de error XAudio2 para obtener descripciones de códigos de error específicos de XAudio2.

Observaciones

Este método solo es válido para las voces de origen y submezcla. La masterización de voces no puede enviar audio a otra voz.

Después de llamar a SetOutputVoices, los niveles de envío actuales de una voz se reemplazarán por una matriz de envío predeterminada. Se debe llamar al método IXAudio2Voice::SetOutputMatrix para establecer una matriz personalizada para la nueva lista de envío.

No es válido llamar a SetOutputVoices desde una devolución de llamada (es decir, IXAudio2EngineCallback o IXAudio2VoiceCallback). Si se llama a SetOutputVoices dentro de una devolución de llamada, devuelve XAUDIO2_E_INVALID_CALL.

Nota Al llamar a SetOutputVoices, se invalidan las matrices de envío establecidas anteriormente con IXAudio2Voice::SetOutputMatrix.
 

Requisitos de la plataforma

Windows 8, Windows Phone 8 (XAudio 2.8); SDK de DirectX (XAudio 2.7)

Requisitos

   
Plataforma de destino Windows
Encabezado xaudio2.h

Consulte también

IXAudio2Voice