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