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


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

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

Синтаксис

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

Параметры

[in] dwIndex

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

[out] pfLevel

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

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

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

Код возврата Описание
E_INVALIDARG
Параметр dwIndex имеет недопустимый номер канала.
E_POINTER
Параметр pfLevel имеет значение 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