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

Метод IAudioStreamVolume::SetAllVolumes (audioclient.h)

  • Статья

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

Синтаксис

HRESULT SetAllVolumes(
  [in] UINT32      dwCount,
  [in] const float *pfVolumes
);

Параметры

[in] dwCount

Количество элементов в массиве pfVolumes . Этот параметр должен равняться количеству каналов в формате потока. Чтобы получить количество каналов, вызовите метод IAudioStreamVolume::GetChannelCount .

[in] pfVolumes

Указатель на массив уровней громкости для каналов в звуковом потоке. Количество элементов в массиве pfVolumes задается параметром dwCount . Вызывающий объект записывает уровень громкости для каждого канала в элемент массива, индекс которого соответствует номеру канала. Если формат потока имеет N каналов, каналы нумеруются от 0 до N–1. Допустимые уровни тома находятся в диапазоне от 0,0 до 1,0.

Возвращаемое значение

Если метод завершается успешно, возвращает значение S_OK. В случае сбоя возможные коды возврата включают, помимо прочего, значения, показанные в следующей таблице.

Код возврата Описание
E_INVALIDARG
 Параметр dwCount не равен числу каналов в потоке или значение элемента массива pfVolumes не находится в диапазоне от 0,0 до 1,0.
E_POINTER
 Параметр pfVolumes имеет значение NULL.
AUDCLNT_E_DEVICE_INVALIDATED
 Устройство конечной точки аудио отключено, звуковое оборудование или связанные аппаратные ресурсы были перенастроены, отключены, удалены или иным образом недоступны для использования.
AUDCLNT_E_SERVICE_NOT_RUNNING
 Служба звука Windows не запущена.

Требования

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

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

Интерфейс IAudioStreamVolume

IAudioStreamVolume::GetChannelCount