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

Статья
02/26/2024

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

Синтаксис

HRESULT GetChannelVolume(
  [in]  UINT32 dwIndex,
  [out] float  *pfLevel
);

Параметры

[in] dwIndex

Номер канала. Если формат потока содержит N каналов, то каналы нумеруются от 0 до N–1. Чтобы получить количество каналов, вызовите метод IAudioStreamVolume::GetChannelCount .

[out] pfLevel

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

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

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

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

Требования

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

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

Интерфейс IAudioStreamVolume

IAudioStreamVolume::GetChannelCount

IAudioStreamVolume::SetAllVolumes

IAudioStreamVolume::SetChannelVolume

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