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

Статья
08/28/2023

Задает параметры фильтра для одного из отправлений этого голоса.

Синтаксис

\\HRESULT SetOutputFilterParameters(
  [in] IXAudio2Voice                   *pDestinationVoice,
  [in] const XAUDIO2_FILTER_PARAMETERS *pParameters,
  [in] UINT32                          OperationSet
);

Параметры

[in] pDestinationVoice

IXAudio2Voice — указатель на конечный голос отправки, параметры фильтра которого будут заданы.

[in] pParameters

Указатель на структуру XAUDIO2_FILTER_PARAMETERS , содержащую сведения о фильтре.

[in] OperationSet

Определяет этот вызов как часть отложенного пакета. Дополнительные сведения см. в обзоре наборов операций XAudio2 .

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

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

SetOutputFilterParameters завершится ошибкой , если отправка не была создана с флагом XAUDIO2_SEND_USEFILTER. Этот метод можно использовать только для отправки, принадлежащих исходному и субмикксовому голосам, и не влияет на отправки голоса, отправляемые мастерингом.

ПримечаниеIXAudio2Voice::GetOutputFilterParameters всегда возвращает фактические текущие параметры фильтра отправки. Однако они могут не соответствовать параметрам, заданным последним вызовом IXAudio2Voice::SetOutputFilterParameters : фактические параметры изменяются только при следующем запуске звукового модуля после вызова IXAudio2Voice::SetOutputFilterParameters (или после соответствующего вызова IXAudio2::CommitChanges , Значение , если IXAudio2Voice::SetOutputFilterParameters был вызван с идентификатором отложенной операции).

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

Windows 10 (XAudio2.9); Windows 8, Windows Phone 8 (XAudio 2.8); Пакет SDK для DirectX (XAudio 2.7)

Требования


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

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

IXAudio2Voice

Поделиться через