Método IXAudio2Voice::SetOutputVoices (xaudio2.h)
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.
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 |