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

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

Синтаксис

HRESULT GetAllVolumes(
  [in]  UINT32 dwCount,
  [out] float  *pfVolumes
);

Параметры

[in] dwCount

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

[out] pfVolumes

Указатель на массив уровней громкости для каналов в звуковом потоке. Этот параметр указывает на выделенный вызывающим объектом массив float , в который метод записывает уровни громкости для отдельных каналов. Уровни громкости находятся в диапазоне от 0,0 до 1,0.

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

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

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

Комментарии

Клиенты могут вызывать метод IAudioStreamVolume::SetAllVolumes или IAudioStreamVolume::SetChannelVolume , чтобы задать уровни громкости для каждого канала в звуковом потоке.

Требования

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

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

Интерфейс IAudioStreamVolume

IAudioStreamVolume::GetChannelCount

IAudioStreamVolume::SetAllVolumes

IAudioStreamVolume::SetChannelVolume