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

  • Статья

Управляет уровнями громкости отдельных звуковых каналов.

Отрисовщик потокового звука (SAR) предоставляет этот интерфейс как услугу. Чтобы получить указатель на интерфейс, вызовите IMFGetService::GetService с идентификатором службы MR_STREAM_VOLUME_SERVICE. Вы можете вызвать GetService непосредственно в SAR или в сеансе мультимедиа.

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

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

Методы

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

 
IMFAudioStreamVolume::GetAllVolumes

Извлекает уровни громкости для всех каналов в звуковом потоке.
IMFAudioStreamVolume::GetChannelCount

Извлекает количество каналов в аудиопотоке.
IMFAudioStreamVolume::GetChannelVolume

Извлекает уровень громкости для указанного канала в звуковом потоке.
IMFAudioStreamVolume::SetAllVolumes

Задает отдельные уровни громкости для всех каналов в аудиопотоке.
IMFAudioStreamVolume::SetChannelVolume

Задает уровень громкости для указанного канала в звуковом потоке.

Комментарии

Если приложению не требуется управление громкостью на уровне канала, можно использовать интерфейс IMFSimpleAudioVolume для управления уровнем громкости master звукового сеанса.

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

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

Используйте следующую формулу для преобразования уровня громкости в масштаб decibel (dB):

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

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

Требования

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

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

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

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