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

  • Статья

Возвращает текущие параметры конкретного эффекта в цепочке эффектов голоса.

Синтаксис

\\HRESULT GetEffectParameters(
  [in]  UINT32 EffectIndex,
  [out] void   *pParameters,
  [out] UINT32 ParametersByteSize
);

Параметры

[in] EffectIndex

Отсчитываемый от нуля индекс эффекта в цепочке эффектов голоса.

[out] pParameters

Возвращает текущие значения параметров, зависящих от эффекта.

[out] ParametersByteSize

Размер массива pParameters в байтах.

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

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

Сбой при E_NOTIMPL, если эффект не поддерживает интерфейс управления универсальными параметрами.

Комментарии

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

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

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

Требования

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

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

IXAPOParameters::GetParameters

IXAudio2Voice

Обзор протокола XAPO