Метод 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 . Ниже приведены возможные значения.

Код возврата	Описание
E_FAIL	Базовое звуковое устройство вернуло ошибку.
E_INVALIDARG	Недопустимое значение lBalance .
E_NOTIMPL	Граф фильтра не содержит фильтр отрисовщика звука. (Возможно, источник не содержит аудиопотока.)
S_OK	Успешно.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	control.h (включая Dshow.h)
Библиотека	Strmiids.lib

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

Коды ошибок и успешного выполнения

Интерфейс IBasicAudio