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


Интерфейс IMFSimpleAudioVolume (mfidl.h)

Управляет уровнем громкости master звукового сеанса, связанного с отрисовщиком потокового звука (SAR) и источником захвата звука.

Sar и источник аудиозахвата предоставляют этот интерфейс как услугу. Чтобы получить указатель на интерфейс, вызовите IMFGetService::GetService. Для SAR используйте идентификатор службы MR_POLICY_VOLUME_SERVICE. Для источника аудиозахвата используйте идентификатор службы MR_CAPTURE_POLICY_VOLUME_SERVICE. Вы можете вызвать GetService непосредственно в sar или источнике аудиозахвата или вызвать его в сеансе мультимедиа.

Наследование

Интерфейс IMFSimpleAudioVolume наследуется от интерфейса IUnknown . IMFSimpleAudioVolume также имеет следующие типы членов:

Методы

Интерфейс IMFSimpleAudioVolume содержит следующие методы.

 
IMFSimpleAudioVolume::GetMasterVolume

Извлекает master уровень тома.
IMFSimpleAudioVolume::GetMute

Запрашивает, отключен ли звук. (IMFSimpleAudioVolume.GetMute)
IMFSimpleAudioVolume::SetMasterVolume

Задает уровень тома master.
IMFSimpleAudioVolume::SetMute

Отключает или отключает звук. (IMFSimpleAudioVolume.SetMute)

Комментарии

Для управления уровнями громкости отдельных каналов используйте интерфейс IMFAudioStreamVolume . Интерфейс IMFAudioStreamVolume поддерживается только sar.

Громкость выражается как уровень затухания, где 0,0 означает тишину, а 1,0 — полный объем (без затухания). Для каждого канала уровень затухания является результатом:

  • Уровень громкости master звукового сеанса.
  • Уровень громкости канала.
Например, если master том равен 0,8, а объем канала равен 0,5, затухание для этого канала равно 0,8 × 0,5 = 0,4. Уровни громкости могут превышать 1,0 (положительное увеличение), но звуковой модуль выполняет клипы для всех звуковых примеров, превышающих ноль децибел. Чтобы изменить уровень громкости отдельных каналов, используйте интерфейс IMFAudioStreamVolume .

Используйте следующую формулу для преобразования уровня тома в децибеле (дБ).

Затухание (дБ) = 20 * log10(Level)

Например, уровень громкости 0,50 представляет 6,02 дБ затухания.

Требования

   
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header mfidl.h

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

Интерфейсы Media Foundation

Отрисовщик потоковой передачи звука