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

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

  • Статья

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

Синтаксис

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

Параметры

[in] dwCount

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

[out] pfVolumes

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

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

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

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

Комментарии

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

Требования

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

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

Интерфейс IChannelAudioVolume

IChannelAudioVolume::GetChannelCount

IChannelAudioVolume::SetAllVolumes

IChannelAudioVolume::SetChannelVolume