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

Метод IAudioEndpointVolume::VolumeStepUp (endpointvolume.h)

  • Статья

Метод VolumeStepUp увеличивает на один шаг уровень громкости звукового потока, который входит в устройство конечной точки звука или покидает его.

Синтаксис

HRESULT VolumeStepUp(
  [in] LPCGUID pguidEventContext
);

Параметры

[in] pguidEventContext

Значение контекста для метода IAudioEndpointVolumeCallback::OnNotify . Этот параметр указывает на GUID контекста события. Если вызов VolumeStepUp изменяет уровень громкости конечной точки, все клиенты, которые зарегистрировали интерфейсы IAudioEndpointVolumeCallback с этой конечной точкой, получат уведомления. В реализации метода OnNotify клиент может проверить GUID контекста события, чтобы определить, является ли он или другой клиент источником события изменения тома. Если вызывающий объект предоставляет указатель NULL для этого параметра, метод уведомления клиента получает указатель контекста NULL .

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

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

Код возврата Описание
E_OUTOFMEMORY
 Недостаточно памяти.

Комментарии

Чтобы получить текущий шаг тома и общее количество шагов в диапазоне томов, вызовите метод IAudioEndpointVolume::GetVolumeStepInfo .

Если уровень тома уже находится на самом высоком шаге в диапазоне томов, вызов VolumeStepUp не оказывает влияния и возвращает код состояния S_OK.

Последовательные интервалы между смежными шагами не обязательно представляют равномерное увеличение объема в линейной амплитуде сигнала или децибелах. В Windows Vista VolumeStepUp определяет связь индекса шага с уровнем громкости (амплитудой сигнала) в виде кривой со сужением звука. Обратите внимание, что форма кривой может измениться в будущих версиях Windows. Дополнительные сведения о кривых с конужением звука см. в разделе Звукоудержимые регуляторы громкости.

Требования

   
Минимальная версия клиента Windows Vista [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2008 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header endpointvolume.h

См. также раздел

Интерфейс IAudioEndpointVolume

IAudioEndpointVolume::GetVolumeStepInfo

Интерфейс IAudioEndpointVolumeCallback

IAudioEndpointVolumeCallback::OnNotify