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

Статья
08/28/2023

Задает общий уровень громкости для голоса.

Синтаксис

\\HRESULT SetVolume(
  [in] float  Volume,
  [in] UINT32 OperationSet
);

Параметры

[in] Volume

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

[in] OperationSet

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

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

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

SetVolume управляет уровнем громкости master входных данных голоса. Уровень громкости master применяется в разное время в зависимости от типа голоса. Для субмикширования и управления голосами уровень громкости применяется непосредственно перед применением встроенной цепочки фильтров и эффектов голоса. Для исходных голосов уровень громкости master применяется после применения фильтра и цепочки эффектов голоса.

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

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

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

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

Требования

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

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

Практическое руководство. Изменение громкости голосовой связи

Руководство: использование субмикшированной речи

IXAudio2Voice

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