Метод 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. В случае сбоя возможные коды возврата включают, помимо прочего, значения, показанные в следующей таблице.
| Код возврата | Описание |
|---|---|
|
Параметр dwIndex имеет недопустимый номер канала. |
|
Параметр pfLevel имеет значение NULL. |
|
Устройство конечной точки аудио отключено, звуковое оборудование или связанные аппаратные ресурсы были перенастроены, отключены, удалены или иным образом недоступны для использования. |
|
Служба звука Windows не запущена. |
Комментарии
Клиенты могут вызывать метод IChannelAudioVolume::SetAllVolumes или IChannelAudioVolume::SetChannelVolume , чтобы задать уровни громкости для каждого канала в звуковом сеансе.
Требования
| Минимальная версия клиента | Windows Vista [только классические приложения] |
| Минимальная версия сервера | Windows Server 2008 [только классические приложения] |
| Целевая платформа | Windows |
| Header | audioclient.h |
См. также раздел
IChannelAudioVolume::GetChannelCount