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

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

Синтаксис

HRESULT VolumeStepDown(
  [in] LPCGUID pguidEventContext
);

Параметры

[in] pguidEventContext

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

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

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

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

Комментарии

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

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

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

Требования

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

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

Интерфейс IAudioEndpointVolume

IAudioEndpointVolume::GetVolumeStepInfo

Интерфейс IAudioEndpointVolumeCallback

IAudioEndpointVolumeCallback::OnNotify