Метод IAudioEndpointVolume::SetMasterVolumeLevel (endpointvolume.h)
Метод SetMasterVolumeLevel задает уровень громкости master (в децибелах) аудиопотока, который входит в устройство конечной точки звука или покидает его.
Синтаксис
HRESULT SetMasterVolumeLevel(
[in] float fLevelDB,
[in] LPCGUID pguidEventContext
);
Параметры
[in] fLevelDB
Новый master уровень громкости в децибелах. Чтобы получить диапазон и степень детализации уровней тома, которые могут быть заданы этим методом, вызовите метод IAudioEndpointVolume::GetVolumeRange .
[in] pguidEventContext
Значение контекста для метода IAudioEndpointVolumeCallback::OnNotify . Этот параметр указывает на GUID контекста события. Если вызов SetMasterVolumeLevel изменяет уровень громкости конечной точки, все клиенты, которые зарегистрировали интерфейсЫ IAudioEndpointVolumeCallback с этой конечной точкой, получат уведомления. В реализации метода OnNotify клиент может проверить GUID контекста события, чтобы определить, является ли он или другой клиент источником события изменения тома. Если вызывающий объект предоставляет указатель NULL для этого параметра, подпрограмма уведомлений получает значение GUID контекста GUID_NULL.
Возвращаемое значение
Если метод завершается успешно, возвращает значение S_OK. В случае сбоя возможные коды возврата включают, но не ограничиваются ими, значения, показанные в следующей таблице.
| Код возврата | Описание |
|---|---|
|
Параметр fLevelDB находится за пределами диапазона томов, поддерживаемого устройством. |
|
Недостаточно памяти. |
Комментарии
Если уровень тома fLevelDB выходит за пределы диапазона томов, сообщаемого методом IAudioEndpointVolume::GetVolumeRange , вызов SetMasterVolumeLevel завершается сбоем и возвращает код ошибки E_INVALIDARG.
Требования
| Минимальная версия клиента | Windows Vista [классические приложения | Приложения UWP] |
| Минимальная версия сервера | Windows Server 2008 [классические приложения | Приложения UWP] |
| Целевая платформа | Windows |
| Header | endpointvolume.h |
См. также раздел
Интерфейс IAudioEndpointVolume
IAudioEndpointVolume::GetVolumeRange