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

Статья
03/04/2024

Возвращает уровни громкости для голоса на канал.

Синтаксис

\\ void GetChannelVolumes(
  [in]  UINT32 Channels,
  [out] float  *pVolumes
);

Параметры

[in] Channels

Подтверждает количество каналов голоса.

[out] pVolumes

Возвращает текущий уровень громкости каждого канала в голосе. Массив должен содержать по крайней мере элементы Channels . Дополнительные сведения об уровнях громкости см. в разделе Примечания.

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

Этот метод не возвращает значение.

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

Уровни громкости выражаются в виде амплитуды с плавающей запятой в диапазоне от -2 ⁴ до 2²⁴ с максимальным увеличением 144,5 дБ. Громкость 1 означает отсутствие затухания или усиления, 0 означает тишину, а отрицательные уровни можно использовать для инвертирования фазы звука. Дополнительные сведения об управлении громкостей см. в разделе Управление громкости И шагом XAudio2 .

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

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

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

Требования

Требование	Значение
Целевая платформа	Windows
Header	xaudio2.h

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

IXAudio2Voice

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