Метод IBasicAudio::p ut_Balance (control.h)
[Функция, связанная с этой страницей DirectShow, является устаревшей функцией. Он был заменен MediaPlayer, IMFMediaEngine, и аудио/ видео захвата в Media Foundation. Эти функции оптимизированы для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует, чтобы новый код использовал MediaPlayer, IMFMediaEngine и аудио- и видеозахват в Media Foundation вместо DirectShow, когда это возможно. Корпорация Майкрософт предлагает переписать существующий код, использующий устаревшие API, чтобы по возможности использовать новые API.]
Метод put_Balance задает баланс звукового сигнала.
Синтаксис
HRESULT put_Balance(
[in] long lBalance
);
Параметры
[in] lBalance
Указывает баланс. Значение может варьироваться от –10 000 до 10 000. Значение -10 000 означает, что правильный канал затухается на 100 дБ и фактически не работает. Значение 10 000 означает, что левый канал не работает. Нейтральное значение равно 0, что означает, что оба канала находятся на полном объеме. Когда один канал затухается, другой остается на полную громкость.
Возвращаемое значение
Возвращает значение HRESULT . Ниже приведены возможные значения.
| Код возврата | Описание |
|---|---|
|
Базовое звуковое устройство вернуло ошибку. |
|
Недопустимое значение lBalance . |
|
Граф фильтра не содержит фильтр отрисовщика звука. (Возможно, источник не содержит аудиопотока.) |
|
Успешно. |
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | control.h (включая Dshow.h) |
| Библиотека | Strmiids.lib |