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