Метод IAudioStreamVolume::SetChannelVolume (audioclient.h)
Метод SetChannelVolume задает уровень громкости для указанного канала в звуковом потоке.
Синтаксис
HRESULT SetChannelVolume(
[in] UINT32 dwIndex,
[in] const float fLevel
);
Параметры
[in] dwIndex
Номер канала. Если формат потока имеет N каналов, каналы нумеруются от 0 до N–1. Чтобы получить количество каналов, вызовите метод IAudioStreamVolume::GetChannelCount .
[in] fLevel
Уровень громкости для канала. Допустимые уровни тома находятся в диапазоне от 0,0 до 1,0.
Возвращаемое значение
Если метод завершается успешно, возвращает значение S_OK. В случае сбоя возможные коды возврата включают, помимо прочего, значения, показанные в следующей таблице.
Код возврата | Описание |
---|---|
|
Параметр dwIndex имеет недопустимый номер канала, или параметр fLevel не находится в диапазоне от 0,0 до 1,0. |
|
Устройство конечной точки аудио отключено, звуковое оборудование или связанные аппаратные ресурсы были перенастроены, отключены, удалены или иным образом недоступны для использования. |
|
Служба звука Windows не запущена. |
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Windows Vista [только классические приложения] |
Минимальная версия сервера | Windows Server 2008 [только классические приложения] |
Целевая платформа | Windows |
Header | audioclient.h |