Метод IXAudio2Voice::SetOutputVoices (xaudio2.h)

  • Статья

Обозначает новый набор подмиксов или голосов для овладения для получения выходных данных голоса.

Синтаксис

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

Параметры

[in] pSendList

Массив указателей структуры XAUDIO2_VOICE_SENDS на целевые голоса. Если pSendList имеет значение NULL, голос будет отправлять свои выходные данные текущему голосу хозяина. Чтобы настроить голос на то, чтобы он нигде не отправлял свои выходные данные, задайте для элемента OutputCountXAUDIO2_VOICE_SENDS значение 0. Все голоса в списке отправки должны иметь одинаковую частоту выборки входных данных. Дополнительные сведения см. в разделе Преобразования частоты выборки XAudio2 .

Возвращаемое значение

Возвращает S_OK в случае успешного выполнения, в противном случае — код ошибки. Описание кодов ошибок XAudio2 см. в разделе Коды ошибок XAudio2 .

Комментарии

Этот метод допустим только для исходных и субмикшных голосов. Мастеринг голосов не может отправить звук другому голосу.

После вызова SetOutputVoices текущие уровни отправки голоса будут заменены матрицей отправки по умолчанию. Чтобы задать настраиваемую матрицу для нового списка отправки, необходимо вызвать метод IXAudio2Voice::SetOutputMatrix .

Недопустимо вызывать SetOutputVoices из обратного вызова (то есть IXAudio2EngineCallback или IXAudio2VoiceCallback). Если метод SetOutputVoices вызывается в рамках обратного вызова, он возвращает XAUDIO2_E_INVALID_CALL.

Примечание Вызов SetOutputVoices делает недействительными все матрицы отправки, ранее заданные с помощью IXAudio2Voice::SetOutputMatrix.
 

Требования к платформе

Windows 8, Windows Phone 8 (XAudio 2.8); Пакет SDK Для DirectX (XAudio 2.7)

Требования

   
Целевая платформа Windows
Header xaudio2.h

См. также раздел

IXAudio2Voice